# List Chains

Every chain of Aurea's chain registry: its family, id and network, its native coin, whether Aurea has its own node for it, whether your tenant enabled it, and how many assets your tenant lists on it.

## Overview

- **One entry per registry row**, mainnets first, then by name. `chain` is the chain as wallets, tokens and balances name it — Base Sepolia is `base` with `isTestnet` `true` —; `registryId` is the row's own id (`base-sepolia`). `chainId` is `null` where the registry holds none for the row.
- `nativeToken`: the chain's coin (`symbol`, `name`, `decimals`), or `null`.
- `platformNode`: whether Aurea has its own node for the chain — what reads a contract when you [register](https://docs.aureahub.com/docs/asset-register.md) or [check](https://docs.aureahub.com/docs/asset-check.md) an asset; where it is `false`, both answer `503` `ASSET_CONTRACT_UNREAD`. The node's address is never answered.
- `enabled`: whether your tenant enabled the chain (its blockchain configuration for that chain id). `assets`: `total` and `active` — your tenant's own assets on the chain and network, never the catalogue's.
- `isTestnet` answers one network only. Any other query parameter answers `400` `ASSET_REQUEST_INVALID`.
- For `owner`, `tenantadmin`, `non_signing_admin`, `signer`, `approver`, `editor`, `viewer` and `auditor`, on their own tenant, with their access token. More in [Asset & Chain Registry](https://docs.aureahub.com/docs/guide-asset-registry.md) › The Chain Registry.

## Endpoint

### `GET /v1/assets/chains`

Authentication: bearer token required.

The chain registry, with your tenant's state on each chain.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | Only this network |

**Responses**

`200` OK

```json
{
  "chains": [
    {
      "chain": "base",
      "registryId": "base",
      "name": "Base",
      "family": "evm",
      "chainId": 8453,
      "isTestnet": false,
      "nativeToken": { "symbol": "ETH", "name": "Ether", "decimals": 18 },
      "platformNode": true,
      "enabled": true,
      "assets": { "total": 1, "active": 1 }
    },
    {
      "chain": "solana",
      "registryId": "solana",
      "name": "Solana",
      "family": "solana",
      "chainId": 1399811149,
      "isTestnet": false,
      "nativeToken": { "symbol": "SOL", "name": "Solana", "decimals": 9 },
      "platformNode": true,
      "enabled": false,
      "assets": { "total": 0, "active": 0 }
    },
    {
      "chain": "base",
      "registryId": "base-sepolia",
      "name": "Base Sepolia",
      "family": "evm",
      "chainId": 84532,
      "isTestnet": true,
      "nativeToken": { "symbol": "ETH", "name": "Sepolia Ether", "decimals": 18 },
      "platformNode": true,
      "enabled": true,
      "assets": { "total": 0, "active": 0 }
    }
  ]
}
```

`400` Form

```json
{
  "statusCode": 400,
  "error": "BadRequestError",
  "message": "Invalid request",
  "details": {
    "code": "ASSET_REQUEST_INVALID",
    "errors": ["(body): Unrecognized key(s) in object: 'chain'"]
  }
}
```

**Example request**

```bash
curl "https://api.aureahub.com/v1/assets/chains?isTestnet=true" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

Web version: https://docs.aureahub.com/#assets-chains