dexdataSign in

Tokens API

Seven-day price sparklines for many tokens

The last seven days of USD prices for up to 25 tokens on one chain, one point per 4-hour bucket, in one request — the small chart beside each row of a watch list or a token table.

POST/api/external/token-analysis/price-sparklines/{chain}
Get a free API keyTry it in the API reference

What it returns

A compact price series for many tokens on one chain in one request: the last seven days, one USD price per 4-hour bucket, oldest first — enough to draw a sparkline next to every row of a watch list. Buckets in which a token did not trade are left out rather than filled, so two consecutive points can be 8 hours or more apart, and a token younger than seven days starts at its first bucket. The newest point is normally the bucket still in progress, and its price is the current one. 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
  • Arc ARC

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-sparklines/SOL"
Parameters
ParameterDescription
chain

path · string · required

The chain every token in the batch lives on. All seven trading chains are served. CELO, ARB, OP and SCROLL return 400 here.
subjects

body · string[] · optional

Token mint addresses (Solana) or contract addresses (EVM). Between 1 and 25, 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 Seven-day price sparklines for many tokens
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.pointsobject[]The series, oldest first. Empty when no series is kept for the token — an unknown address, but also some tokens that do trade — so an empty list does not mean the token had no trades.
results[].result.points[].atnumberThe start of the 4-hour bucket, Unix seconds (a multiple of 14,400).
results[].result.points[].usdnumberThe price of one token in USD in that bucket.
results[].result.points[].completebooleanWhether the bucket had ended when the request was answered. false on the bucket in progress, whose price is the latest one.
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