List Tokens
List registered canonical token definitions in editorial order. Ranked rows come first, by rank; unranked rows follow, by symbol. Filter by CAIP-2 chain, bound the page, and continue from the cursor.
GET /tokens
GET /tokens?chain-id=eip155:8453
GET /tokens?chain-id=eip155:8453&limit=2
GET /tokens?chain-id=eip155:8453&limit=2&cursor=<nextCursor>
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
chain-id | string | No | Filter by CAIP-2 chain identifier. |
limit | integer | No | Page size, clamped to 1–200. Defaults to 50. |
cursor | string | No | The nextCursor from the previous page. Must match the filters. |
totals | boolean | No | Return the matching count in total. Accepts true or false. |
Response
One object per page. total is returned only when totals=true, on every page
including a cursor page. Without the flag it is null. nextCursor is null
on the last page.
Every page answers Cache-Control: public, max-age=60. The data changes only on
deploy, so a correction reaches readers when the window expires.
{
"items": [
{
"symbol": "USDC",
"chainId": "eip155:1",
"address": "eip155:1:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"decimals": 6,
"metadata": {
"name": "USDC",
"logoURI": "https://static.alchemyapi.io/images/assets/3408.png",
"coingeckoId": "usd-coin",
"description": "USDC is a fully collateralized US dollar stablecoin."
}
}
],
"total": 20,
"nextCursor": "eyJ2IjoxLCJrIjpbImVpcDE1NTo4NDUzIiwyLCJXRVRIIl0sImYiOnt9fQ"
}Walking the pages
Send the same filters with the previous page's nextCursor until nextCursor
is null. Consecutive pages partition the matching set: no row repeats and none
is skipped.
cursor=""
while :; do
page=$(curl -s -H "api-key: $API_KEY" \
"https://api.mure.app/v2/tokens?chain-id=eip155:8453&limit=50${cursor:+&cursor=$cursor}")
echo "$page" | jq -r '.items[].symbol'
cursor=$(echo "$page" | jq -r '.nextCursor // empty')
[ -z "$cursor" ] && break
doneThe cursor is opaque. Decode nothing from it, and never send a cursor with a
different chain-id or search: the API refuses it with invalid-cursor.
Response Fields
| Field | Type | Description |
|---|---|---|
items | TokenDefinition[] | This page's rows, in editorial order. |
total | integer | null | The matching count, only when totals=true; else null. |
nextCursor | string | null | The next page's cursor, or null on the last page. |
TokenDefinition
| Field | Type | Description |
|---|---|---|
symbol | string | Canonical token symbol. |
chainId | string | CAIP-2 chain identifier. |
address | string | CAIP-10 account address for the token contract. |
decimals | integer | Token decimal places. |
metadata | Metadata | null | Token image and display data, or null. |
Metadata
Every field is best-effort: a source that omits a value leaves it null, so an
unenriched token still returns all four keys.
| Field | Type | Description |
|---|---|---|
name | string | null | Display name from the token contract. |
logoURI | string | null | Token image URL. |
coingeckoId | string | null | CoinGecko coin id, for market data and deeper links. |
description | string | null | Short description, capped at 500 characters. |
Errors
| HTTP | Type | When |
|---|---|---|
| 400 | bad-request | A query parameter fails schema validation. |
| 400 | invalid-cursor | The cursor does not decode, or was minted under a different filter set. |
| 401 | missing-api-key | No api-key header. |
| 403 | invalid-api-key | Invalid API key. |
| 429 | rate-limited | Rate limit exceeded. |
| 500 | token-registry-service-failure | Unexpected token registry error. |