Skip to main content
POST
POST /v1/token/metadata · 1 credit per 25 items Batch twin: the metadata of up to 100 {chain, address} items in one call, EVM and Solana mixed freely. The response comes back 200 in input order, one slot per item: { data }, exactly the body of GET /v1/token/metadata for that token, or { error: { code, message } } for that item alone (unknown token, malformed address), never null. One bad item never costs you the rest of the lot. Billed 1 credit per 25 items served: 1 to 25 items cost 1 credit, 26 to 50 cost 2.
A slot’s data is exactly what GET /v1/token/metadata returns: iconUrl and headerUrl are always fetchable https URLs (null when no image is available), dexPaid is true, false or null (status unknown), coingeckoUrl is the token’s CoinGecko page (null when it has none) and listed says whether CoinGecko lists the token (true, false, or null when unknown). The row ends with the DEX Screener products: dexAdPaid and dexAdPaidAt (an ad paid, and when the first was), dexscreenerBoostedAt (the first boost), dexscreenerBoostActive (a boost running now) and dexscreenerListed (a page on DEX Screener), each null when unknown.

Authorizations

Authorization
string
header
required

Your raw API key (not needed on the demo server).

Body

application/json
items
object[]
required

1 to 100 of {chain, address}, across chains. Each item takes address or its other name, tokenAddress.

Required array length: 1 - 100 elements
Example:

Response

200

Standard { data, meta } envelope.