Tokens API

Prices of many tokens in USD

What up to 30 tokens on one chain cost in USD right now, in one request, each with a flag saying whether a second independent source agreed within tolerance.

POST/api/external/token-analysis/price-batch/{chain}

What it returns

The price answer for many tokens on one chain in one request. Each result is exactly what price answers for that token. POST, because the list is the subject: it can run past what a URL comfortably holds, and a body keeps a watch list out of every proxy log between the caller and this service.

Chains

  • Solana SOL
  • BNB Chain BNB
  • Ethereum ETH
  • Stable STABLE
  • Base BASE
  • Robinhood Chain RHC

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -X POST -H "x-dex-data-key: $DEXDATA_API_KEY" \
  -H "content-type: application/json" \
  -d '{"subjects":["<subjects>"]}' \
  "https://api.dexdata.io/api/external/token-analysis/price-batch/SOL"
Parameters
ParameterDescription
chain

path · string · required

The chain every token in the batch lives on. Every trading chain but ARC is served. CELO, ARB, OP and SCROLL return 400 here.
subjects

body · string[] · optional

Token mint addresses (Solana) or contract addresses (EVM). Between 1 and 30, each sent once.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Prices of many tokens in USD
FieldTypeDescription
resultsobject[]One entry per requested subject, in the order they were sent.
results[].subjectstringThe subject exactly as it was sent.
results[].resultobject | nullWhat the single-subject endpoint answers for this subject. null only when error is set.
results[].result.usdnumber | nullUSD price of one token, or null when nobody had a price or two sources disagreed.
results[].result.corroboratedbooleanWhether a second, independent source confirmed the figure.
results[].errorstring | nullnull, or unavailable when no source could be reached for this subject — retry it. A subject nobody has data for is NOT an error: its result says so.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key