StatusTerminal
APIUse casesOracleMCP & AgentsSDKsSkillsChangelog

Token market list, ranked by market cap

GET
/tokens

One row per token per chain, with the figures of every pair it trades in rolled up — price, 24h volume and transactions, liquidity, market cap, FDV, holders and the rating. Sorted by market cap unless sort says otherwise; a blocked token never appears. Rows the canonical registry knows carry its id, slug, status and logo; a row it does not know carries the all-zero id. includes echoes which optional registry blocks the response carries.

Query Parameters

q?string

token name, ticker or address

Lengthlength <= 128
chains?array<>

comma-separated chain slugs or ids; omit for every live chain

Itemsitems <= 32
categories?array<>

comma-separated category slugs; a token matches when it carries any of them

Itemsitems <= 32
sort?string

sort key

Default"market_cap"

Value in

  • "market_cap"
  • "volume"
  • "liquidity"
  • "price_change"
  • "created_at"
  • "holders"
  • "rating"
  • "fdv"
  • "txns"
order?string

sort direction

Default"desc"

Value in

  • "asc"
  • "desc"
min_liquidity_usd?number

inclusive lower bound on liquidity across the token's pairs

Formatdouble
Range0 <= value
max_liquidity_usd?number

inclusive upper bound on liquidity across the token's pairs

Formatdouble
Range0 <= value
min_volume_usd?number

inclusive lower bound on the 24h volume

Formatdouble
Range0 <= value
max_volume_usd?number

inclusive upper bound on the 24h volume

Formatdouble
Range0 <= value
min_market_cap_usd?number

inclusive lower bound on market cap

Formatdouble
Range0 <= value
max_market_cap_usd?number

inclusive upper bound on market cap

Formatdouble
Range0 <= value
min_fdv_usd?number

inclusive lower bound on fully diluted valuation

Formatdouble
Range0 <= value
max_fdv_usd?number

inclusive upper bound on fully diluted valuation

Formatdouble
Range0 <= value
min_age_seconds?integer

exclude tokens launched more recently than this

Formatuint32
Range0 <= value
max_age_seconds?integer

exclude tokens launched longer ago than this

Formatuint32
Range0 <= value
min_score?integer

inclusive lower bound on the token trust score

Formatuint32
Range0 <= value <= 100
max_score?integer

inclusive upper bound on the token trust score

Formatuint32
Range0 <= value <= 100
min_holders?integer

inclusive lower bound on the holders we track

Formatuint32
Range0 <= value
max_holders?integer

inclusive upper bound on the holders we track

Formatuint32
Range0 <= value
include_instances?boolean

include chain deployments for every item

Defaultfalse
include_market?boolean

include price and market metrics for every item

Defaultfalse
limit?integer

page size; plans above startup may raise the ceiling

Formatint32
Range1 <= value <= 100
Default10
cursor?string

opaque cursor from next_cursor or prev_cursor

Lengthlength <= 512

Header Parameters

Accept-Payment?string

payment methods the client can use, comma-separated, case-insensitive. With x402 in the list, a spent keyless budget answers 402 with the x402 challenge instead of 429.

PAYMENT-SIGNATURE?string

base64 x402 v2 payment payload for this request. A paid request skips the keyless budget and is settled only when it answers 2xx. The v1 header X-PAYMENT is accepted too.

Response Body

application/json

application/problem+json

application/problem+json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/tokens"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "slug": "string",      "symbol": "string",      "name": "string",      "description": "string",      "status": "string",      "confidence": 0,      "category": "string",      "rank": 1,      "logo_url": "http://example.com",      "market": {        "observed_at": "2019-08-24T14:15:22Z",        "expires_at": "2019-08-24T14:15:22Z",        "metrics": {          "price_usd": "string",          "liquidity_usd": "string",          "market_cap_usd": "string",          "fdv_usd": "string",          "circulating_supply": "string",          "total_supply": "string",          "holders_count": 0        },        "windows": {          "property1": {            "price_change_percent": "string",            "volume_usd": "string",            "buys": 0,            "sells": 0,            "transactions": 0          },          "property2": {            "price_change_percent": "string",            "volume_usd": "string",            "buys": 0,            "sells": 0,            "transactions": 0          }        },        "primary_market": {          "chain_id": 1,          "pair_address": "string",          "dex_id": "string",          "liquidity_usd": "string"        }      },      "instances": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "chain_id": 1,          "address": "string",          "decimals": 0,          "status": "string",          "risk_score": 0,          "contract_verified": true,          "market": {            "observed_at": "2019-08-24T14:15:22Z",            "expires_at": "2019-08-24T14:15:22Z",            "metrics": {              "price_usd": "string",              "liquidity_usd": "string",              "market_cap_usd": "string",              "fdv_usd": "string",              "circulating_supply": "string",              "total_supply": "string",              "holders_count": 0            },            "windows": {              "property1": {                "price_change_percent": "string",                "volume_usd": "string",                "buys": 0,                "sells": 0,                "transactions": 0              },              "property2": {                "price_change_percent": "string",                "volume_usd": "string",                "buys": 0,                "sells": 0,                "transactions": 0              }            },            "primary_market": {              "chain_id": 1,              "pair_address": "string",              "dex_id": "string",              "liquidity_usd": "string"            }          }        }      ],      "chain": {        "slug": "hyperliquid",        "chain_id": 0      },      "address": "string",      "decimals": 0,      "score": 0,      "categories": [        "string"      ],      "price_usd": 0.1,      "price_change_1h": 0.1,      "price_change_6h": 0.1,      "price_change_24h": 0.1,      "volume_24h": 0.1,      "txns_24h": 0,      "liquidity_usd": 0.1,      "pairs_count": 0,      "fdv_usd": 0.1,      "market_cap_usd": 0.1,      "market_cap_estimated": true,      "total_supply": 0.1,      "max_supply": 0.1,      "circulating_supply": 0.1,      "holders": 0,      "launched_at": "string",      "rating": {        "score": 0,        "safety": 0,        "liquidity": 0,        "activity": 0,        "holders": 0,        "age_info": 0      },      "main_pair": {        "address": "string",        "ticker": "string"      },      "launch": {        "deployer": "string",        "tx_hash": "string",        "block_number": 0,        "deployed_at": "string"      },      "windows": {        "m5": {          "price_change_pct": 0.1,          "volume_usd": 0.1,          "buy_volume_usd": 0.1,          "sell_volume_usd": 0.1,          "txns": {            "buys": 0,            "sells": 0          },          "buyers": 0,          "sellers": 0,          "makers": 0,          "makers_main_pair_only": true        },        "h1": {          "price_change_pct": 0.1,          "volume_usd": 0.1,          "buy_volume_usd": 0.1,          "sell_volume_usd": 0.1,          "txns": {            "buys": 0,            "sells": 0          },          "buyers": 0,          "sellers": 0,          "makers": 0,          "makers_main_pair_only": true        },        "h6": {          "price_change_pct": 0.1,          "volume_usd": 0.1,          "buy_volume_usd": 0.1,          "sell_volume_usd": 0.1,          "txns": {            "buys": 0,            "sells": 0          },          "buyers": 0,          "sellers": 0,          "makers": 0,          "makers_main_pair_only": true        },        "h24": {          "price_change_pct": 0.1,          "volume_usd": 0.1,          "buy_volume_usd": 0.1,          "sell_volume_usd": 0.1,          "txns": {            "buys": 0,            "sells": 0          },          "buyers": 0,          "sellers": 0,          "makers": 0,          "makers_main_pair_only": true        }      },      "holder_stats": {        "count": 0,        "top10_pct": 0.1,        "updated_at": "string"      },      "profile": {        "image_url": "http://example.com",        "websites": [          "string"        ],        "socials": {          "twitter": [            "string"          ],          "telegram": [            "string"          ],          "discord": [            "string"          ],          "github": [            "string"          ],          "docs": [            "string"          ]        },        "verified": true,        "verification_tier": "string",        "verified_by": [          "string"        ]      }    }  ],  "next_cursor": "string",  "prev_cursor": "string",  "includes": {    "instances": true,    "market": true  }}

Canonical token by slug GET

Previous Page

Resolve many tokens at once POST

Resolves up to 200 deployment references in one call. Unresolvable references come back with `found: false` rather than failing the batch.