curl -X POST 'https://api.serialized.xyz/v1/token/sparklines' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"chain": "evm:8453", "tokens": ["0x4ed4e862860bed51a9570b96d89af5e1b0efefed"], "timeframe": "24h"}'
{
"data": {
"0x4ed4e862860bed51a9570b96d89af5e1b0efefed": [
5.249040755790959e-7,
5.299419269878368e-7,
5.341024278723588e-7,
5.353384270094856e-7,
5.367245992625111e-7,
5.382859734840854e-7,
"…"
]
},
"meta": {
"asOf": 1786725098728,
"timeframe": "24h",
"quote": "native"
}
}
{
"data": {
"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN": [
{ "at": 1790701200000, "value": 2.0211635444550846 },
{ "at": 1790704800000, "value": 2.0451174906709944 },
{ "at": 1790708400000, "value": 2.0222823998521657 },
{ "at": 1790712000000, "value": 2.042120738574924 },
"…"
]
},
"meta": {
"asOf": 1790787309837,
"timeframe": "24h",
"quote": "usd"
}
}
Token Sparklines
Small price arrays for token list rows - one call for up to 100 tokens on a chain. We resolve each token’s best pool (curve history stitched in) and return one evenly spaced line per token; a token younger than the timeframe gets a finer interval so its whole life fills the line. Timeframes 1m|5m|30m|1h|24h|7d, native or USD, optional timestamps. Unknown tokens return [] - we never invent data.
curl -X POST 'https://api.serialized.xyz/v1/token/sparklines' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"chain": "evm:8453", "tokens": ["0x4ed4e862860bed51a9570b96d89af5e1b0efefed"], "timeframe": "24h"}'
{
"data": {
"0x4ed4e862860bed51a9570b96d89af5e1b0efefed": [
5.249040755790959e-7,
5.299419269878368e-7,
5.341024278723588e-7,
5.353384270094856e-7,
5.367245992625111e-7,
5.382859734840854e-7,
"…"
]
},
"meta": {
"asOf": 1786725098728,
"timeframe": "24h",
"quote": "native"
}
}
{
"data": {
"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN": [
{ "at": 1790701200000, "value": 2.0211635444550846 },
{ "at": 1790704800000, "value": 2.0451174906709944 },
{ "at": 1790708400000, "value": 2.0222823998521657 },
{ "at": 1790712000000, "value": 2.042120738574924 },
"…"
]
},
"meta": {
"asOf": 1790787309837,
"timeframe": "24h",
"quote": "usd"
}
}
POST /v1/token/sparklines · 1 per token credit
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. To spark specific pools instead, use POST /v1/pools/sparklines.
| Timeframe | Points | Interval (at most) |
|---|---|---|
1m | 30 | 2 s |
5m | 30 | 10 s |
30m | 30 | 1 min |
1h | 30 | 2 min |
24h | 24 | 1 h |
7d | 28 | 6 h |
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: truereturns each point as{ at, value },atbeing 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 Solana, each point converted at the SOL/USD rate of its own time. Native prices are the default on every chain.
curl -X POST 'https://api.serialized.xyz/v1/token/sparklines' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"chain": "evm:8453", "tokens": ["0x4ed4e862860bed51a9570b96d89af5e1b0efefed"], "timeframe": "24h"}'
{
"data": {
"0x4ed4e862860bed51a9570b96d89af5e1b0efefed": [
5.249040755790959e-7,
5.299419269878368e-7,
5.341024278723588e-7,
5.353384270094856e-7,
5.367245992625111e-7,
5.382859734840854e-7,
"…"
]
},
"meta": {
"asOf": 1786725098728,
"timeframe": "24h",
"quote": "native"
}
}
{
"data": {
"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN": [
{ "at": 1790701200000, "value": 2.0211635444550846 },
{ "at": 1790704800000, "value": 2.0451174906709944 },
{ "at": 1790708400000, "value": 2.0222823998521657 },
{ "at": 1790712000000, "value": 2.042120738574924 },
"…"
]
},
"meta": {
"asOf": 1790787309837,
"timeframe": "24h",
"quote": "usd"
}
}
Authorizations
Your raw API key (not needed on the demo server).
Body
Public chain id - evm:<id> or solana. One chain per call.
"evm:8453"
1 to 100 token addresses on chain. Billed per token.
1 - 100 elements[
"0x4ed4e862860bed51a9570b96d89af5e1b0efefed"
]
1 - 100 elements1m|5m|30m|1h|24h|7d. Default 24h.
"24h"
native (default) or usd. usd converts each point at the SOL/USD rate of its own time; available on Solana.
native "native"
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.
true
Response
Standard { data, meta } envelope.