Resolve many tokens at once
Resolves up to 200 deployment references in one call. Unresolvable references come back with found: false rather than failing the batch.
Header Parameters
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.
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.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
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 POST "https://example.com/tokens/batch" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "chain": "hyperliquid", "address": "string" } ] }'{ "items": [ { "chain": "hyperliquid", "address": "string", "found": true, "token": { "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" ] } } } ]}Token market list, ranked by market cap GET
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.
Top holders of a token GET
Wallets holding the token now, largest balance first, with their labels. Balances are the positions avee reconstructs from swaps and transfers it indexes, so a wallet that only ever received the token outside an indexed venue can be missing. `holder_stats` — count and top-ten share from the holder sweep, the same block the token carries — rides on the first page only.