# List assets

`GET /v1/assets`

Returns the currencies and crypto assets that Circuitry supports, with the tokens that represent each one on each chain.

## Request

```bash
curl "https://api.circuitry.company/v1/assets?chain=base" \
  -H "Authorization: Bearer $CIRCUITRY_API_KEY"
```

| Query parameter | Meaning |
| --- | --- |
| `chain` | Optional. `base` or `robinhood`, to list only that chain |
| `type` | Optional. `fx` for currencies, or `crypto` for crypto assets |

## Response

```json
{
  "object": "list",
  "data": [
    {
      "object": "asset",
      "type": "fx",
      "currency": "USD",
      "name": "US dollar",
      "chains": [
        {
          "chain": "base",
          "chainId": 8453,
          "tokens": [
            {
              "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "symbol": "USDC",
              "name": "USD Coin",
              "decimals": 6
            }
          ]
        }
      ]
    },
    {
      "object": "asset",
      "type": "crypto",
      "symbol": "ETH",
      "name": "Ether",
      "chains": [
        {
          "chain": "base",
          "chainId": 8453,
          "tokens": [
            { "address": null, "symbol": "ETH", "name": "Ether", "decimals": 18 }
          ]
        }
      ]
    }
  ]
}
```

| Field | Meaning |
| --- | --- |
| `object` | Always `asset` |
| `type` | `fx` for a currency, or `crypto` for a crypto asset |
| `currency` | For `fx`, the ISO 4217 code |
| `symbol` | For `crypto`, the asset's symbol |
| `name` | The asset's name |
| `chains` | Each chain the asset is on, by name and chain ID |
| `chains[].tokens` | The tokens that represent the asset on that chain. An asset can have more than one |
| `tokens[].address` | The token's contract, or `null` for native ETH |
| `tokens[].decimals` | The token's decimals |

The chains are Base (8453) and Robinhood Chain (4663).

## Errors

This endpoint returns `invalid_request` for a query parameter or value it doesn't take, the errors in [Failed authentication](/authentication#failed-authentication), and `internal_error`.