> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravn.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /tokens

> RAVN's own listed token registry for a chain.

Populate a token picker without maintaining your own list. This is "what RAVN knows about and
might route," the same source retail's own token picker reads from, not a routability guarantee
for a specific pair, request a [quote](/api-reference/quote) to actually check that.

<Note>
  Not on this list doesn't mean unswappable. Any address is still swappable via
  [`/tokens/resolve`](/api-reference/tokens) as a paste-any-address flow. And for the narrower
  "can this be bought **from** native BTC" question specifically, see
  [`/tokens/btc-coverage`](/api-reference/btc-coverage) instead, this endpoint doesn't filter on
  routability the way that one does.
</Note>

## Request

<ParamField query="chainId" type="integer" required>The chain to list tokens for.</ParamField>

No API key required (see [Authentication](/authentication) for the optional higher-limit tiers).

```bash theme={null}
curl -s "https://app.ravn.exchange/api/v1/tokens?chainId=1"
```

## Response

An array of:

<ResponseField name="symbol" type="string" />

<ResponseField name="name" type="string" />

<ResponseField name="address" type="string">Contract address, or mint on Solana.</ResponseField>

<ResponseField name="decimals" type="integer" />

<ResponseField name="chainId" type="integer" />

<ResponseField name="isNative" type="boolean" />

<ResponseField name="logoUrl" type="string">Absent on a token with no logo asset yet.</ResponseField>

```json theme={null}
{
  "data": [
    {
      "symbol": "ETH",
      "name": "Ether",
      "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "decimals": 18,
      "chainId": 1,
      "isNative": true
    },
    {
      "symbol": "USDC",
      "name": "USD Coin",
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "decimals": 6,
      "chainId": 1,
      "isNative": false
    }
  ]
}
```

Returns `400 UNSUPPORTED_CHAIN` if `chainId` isn't one RAVN lists tokens for.
