Skip to content
LogoLogo

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

ParameterTypeRequiredDescription
chain-idstringNoFilter by CAIP-2 chain identifier.
limitintegerNoPage size, clamped to 1–200. Defaults to 50.
cursorstringNoThe nextCursor from the previous page. Must match the filters.
totalsbooleanNoReturn 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
done

The 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

FieldTypeDescription
itemsTokenDefinition[]This page's rows, in editorial order.
totalinteger | nullThe matching count, only when totals=true; else null.
nextCursorstring | nullThe next page's cursor, or null on the last page.

TokenDefinition

FieldTypeDescription
symbolstringCanonical token symbol.
chainIdstringCAIP-2 chain identifier.
addressstringCAIP-10 account address for the token contract.
decimalsintegerToken decimal places.
metadataMetadata | nullToken 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.

FieldTypeDescription
namestring | nullDisplay name from the token contract.
logoURIstring | nullToken image URL.
coingeckoIdstring | nullCoinGecko coin id, for market data and deeper links.
descriptionstring | nullShort description, capped at 500 characters.

Errors

HTTPTypeWhen
400bad-requestA query parameter fails schema validation.
400invalid-cursorThe cursor does not decode, or was minted under a different filter set.
401missing-api-keyNo api-key header.
403invalid-api-keyInvalid API key.
429rate-limitedRate limit exceeded.
500token-registry-service-failureUnexpected token registry error.