Skip to main content
POST
POST /v1/token/sparklines · 1 credit per 25 tokens Small price arrays for token list rows - one call for up to 100 tokens. We resolve each token’s best pool for you and stitch bonding-curve history onto it, so a freshly graduated token draws one continuous line. The response is keyed by token address. One token: GET /v1/token/sparklines, the same line. To spark specific pools instead, use POST /v1/pool/sparklines. Every line is a grid of evenly spaced points, oldest to newest, the last one being the live price. A token older than the timeframe gets the interval above and the line covers the whole timeframe. A younger token keeps the same number of points on a finer interval, the finest that still spans its whole life (a 3-hour-old token on 24h draws 24 points of 10 minutes; a 1-minute-old token on 1h draws 30 points of 2 seconds), so a fresh launch draws a real line instead of a single point. An interval without a trade carries the previous price, and before the first trade a line holds its first price: you always get the full grid, or []. Two options shape the points:
  • timestamps: true returns each point as { at, value }, at being the start of its interval in unix milliseconds: the way to know the interval a line was drawn on. Dated points start at the first trade, so a line can hold fewer points than the grid.
  • quote: "usd" returns USD prices on every chain except Story (evm:1514, where it returns 400). Native prices are the default on every chain.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
chain
string
required

Public chain id - evm:<id> or solana. One chain per call.

Example:

"evm:8453"

​
tokens
string[]

1 to 100 token addresses on chain. Billed as one call per 25 tokens: up to 25 tokens cost 1 credit, 26 to 50 cost 2 credits, and so on.

Required array length: 1 - 100 elements
Example:
​
pools
string[]
Required array length: 1 - 100 elements
​
timeframe
string
default:24h

1m|5m|30m|1h|24h|7d. Default 24h.

Example:

"24h"

​
quote
default:native

native (default) or usd: usd serves each point in dollars, on every chain except Story (evm:1514).

Available options:
native
Example:

"native"

​
timestamps
boolean
default:false

true returns each point as { at, value }, at being the start of the point's interval in unix milliseconds, from the first trade of the window on. Default false: bare numbers, always the full grid.

Example:

true

Response

200

Standard { data, meta } envelope.