curl -X POST 'https://api.serialized.xyz/v1/pool/sparklines' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items": [{"chain": "evm:8453", "address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64"}], "timeframe": "24h"}'
{
"data": {
"0x0ca6485b7e9cf814a3fd09d81672b07323535b64": [
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": {
"3C5YE97HADPDxZehYq9Cis8AXr9aNyrUsczKzE1nDbW9": [
{ "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"
}
}
Pool Sparklines
Pool Sparklines: batch
Small price arrays for list rows - one call for up to 100 markets, cross-chain, keyed by pool, one evenly spaced line per market that covers the whole timeframe. Timeframes 1m|5m|30m|1h|24h|7d, native or USD, optional timestamps. Missing pools return [] - we never invent data.
POST
/
v1
/
pool
/
sparklines
curl -X POST 'https://api.serialized.xyz/v1/pool/sparklines' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items": [{"chain": "evm:8453", "address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64"}], "timeframe": "24h"}'
{
"data": {
"0x0ca6485b7e9cf814a3fd09d81672b07323535b64": [
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": {
"3C5YE97HADPDxZehYq9Cis8AXr9aNyrUsczKzE1nDbW9": [
{ "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/pool/sparklines · 1 credit per 25 markets
Small price arrays for list rows - one call for up to 100 markets in one request, each {chain, address} (or {chain, poolAddress}) so the batch can span chains. The response is keyed by pool address. One market: GET /v1/pool/sparklines, the same line. For token-level sparklines (best pool resolved for you), use POST /v1/token/sparklines.
| Timeframe | Points | Interval |
|---|---|---|
1m | 30 | 2 s |
5m | 30 | 10 s |
30m | 30 | 1 min |
1h | 30 | 2 min |
24h | 24 | 1 h |
7d | 28 | 6 h |
Formerly
POST /v1/pools/sparklines. The former path still answers the same call, at the same price, and markets[], the former name of items[], is still accepted (send one of the two).[].
Two options shape the points:
timestamps: truereturns each point as{ at, value },atbeing the start of its interval in unix milliseconds. Dated points start at the first trade of the timeframe, so a market younger than the timeframe returns fewer points.quote: "usd"returns USD prices on every chain except Story (evm:1514: a request with a Story market returns400). Native prices are the default on every chain, andquoteapplies to the whole request.
curl -X POST 'https://api.serialized.xyz/v1/pool/sparklines' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items": [{"chain": "evm:8453", "address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64"}], "timeframe": "24h"}'
{
"data": {
"0x0ca6485b7e9cf814a3fd09d81672b07323535b64": [
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": {
"3C5YE97HADPDxZehYq9Cis8AXr9aNyrUsczKzE1nDbW9": [
{ "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
application/json
1 to 100 of {chain, address} (or {chain, poolAddress}) pools, across chains. Billed as one call per 25 markets: up to 25 markets cost 1 credit, 26 to 50 cost 2 credits, and so on. Each item takes address or its other name, poolAddress.
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Example:
[
{ "chain": "evm:8453", "address": "0x0ca6…" }
]
The former name of items, still accepted: send one of the two.
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
1m|5m|30m|1h|24h|7d. Default 24h.
Example:
"24h"
native (default) or usd: usd serves each point in dollars, on every chain except Story (evm:1514).
Available options:
native Example:
"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.
Example:
true
Response
200
Standard { data, meta } envelope.