curl 'https://api.serialized.xyz/v1/token/stats?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/stats?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/stats?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&pools=0x0ca6485b7e9cf814a3fd09d81672b07323535b64&windows=1h,24h' -H 'Authorization: YOUR_API_KEY'
{
"data": {
"5m": {
"volumeNative": 0,
"volumeUsd": 0,
"buys": 0,
"sells": 0,
"txns": 0,
"buyVolumeNative": 0,
"sellVolumeNative": 0,
"priceChangePct": null
},
"1h": {
"volumeNative": 0.412094882336,
"volumeUsd": 775.71,
"buys": 4,
"sells": 2,
"txns": 6,
"buyVolumeNative": 0.398210102336,
"sellVolumeNative": 0.01388478,
"priceChangePct": 0.31844021
},
"6h": {
"volumeNative": 3.284880922336,
"volumeUsd": 6183.15,
"buys": 41,
"sells": 3,
"txns": 43,
"buyVolumeNative": 3.107442612402,
"sellVolumeNative": 0.177438309934,
"priceChangePct": 1.20455082
},
"24h": {
"volumeNative": 12.472824758820,
"volumeUsd": 23448.598725963,
"buys": 176,
"sells": 5,
"txns": 178,
"buyVolumeNative": 11.839201571847,
"sellVolumeNative": 0.633623186973,
"priceChangePct": 7.328276263872
}
},
"meta": {
"asOf": 1786725098444
}
}
{
"data": {
"1h": {
"volumeNative": 121.884073442,
"volumeUsd": 9160.42,
"buys": 388,
"sells": 402,
"buyVolumeNative": 61.402113,
"sellVolumeNative": 60.481960,
"txns": 784,
"priceChangePct": 0.492817
},
"24h": {
"volumeNative": 2466.120265838,
"volumeUsd": 185331.954920982,
"buys": 7534,
"sells": 8681,
"buyVolumeNative": 1244.830172419,
"sellVolumeNative": 1221.290093419,
"txns": 16108,
"priceChangePct": 3.636601730081
}
},
"meta": {
"asOf": 1786745258937
}
}
Token Stats
Token Stats
Windowed volume, buy/sell counts and volumes, transactions and price change - 5m/1h/4h/6h/24h in one call. Token-wide across every pool by default.
GET
/
v1
/
token
/
stats
curl 'https://api.serialized.xyz/v1/token/stats?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/stats?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/stats?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&pools=0x0ca6485b7e9cf814a3fd09d81672b07323535b64&windows=1h,24h' -H 'Authorization: YOUR_API_KEY'
{
"data": {
"5m": {
"volumeNative": 0,
"volumeUsd": 0,
"buys": 0,
"sells": 0,
"txns": 0,
"buyVolumeNative": 0,
"sellVolumeNative": 0,
"priceChangePct": null
},
"1h": {
"volumeNative": 0.412094882336,
"volumeUsd": 775.71,
"buys": 4,
"sells": 2,
"txns": 6,
"buyVolumeNative": 0.398210102336,
"sellVolumeNative": 0.01388478,
"priceChangePct": 0.31844021
},
"6h": {
"volumeNative": 3.284880922336,
"volumeUsd": 6183.15,
"buys": 41,
"sells": 3,
"txns": 43,
"buyVolumeNative": 3.107442612402,
"sellVolumeNative": 0.177438309934,
"priceChangePct": 1.20455082
},
"24h": {
"volumeNative": 12.472824758820,
"volumeUsd": 23448.598725963,
"buys": 176,
"sells": 5,
"txns": 178,
"buyVolumeNative": 11.839201571847,
"sellVolumeNative": 0.633623186973,
"priceChangePct": 7.328276263872
}
},
"meta": {
"asOf": 1786725098444
}
}
{
"data": {
"1h": {
"volumeNative": 121.884073442,
"volumeUsd": 9160.42,
"buys": 388,
"sells": 402,
"buyVolumeNative": 61.402113,
"sellVolumeNative": 60.481960,
"txns": 784,
"priceChangePct": 0.492817
},
"24h": {
"volumeNative": 2466.120265838,
"volumeUsd": 185331.954920982,
"buys": 7534,
"sells": 8681,
"buyVolumeNative": 1244.830172419,
"sellVolumeNative": 1221.290093419,
"txns": 16108,
"priceChangePct": 3.636601730081
}
},
"meta": {
"asOf": 1786745258937
}
}
GET /v1/token/stats · 1 credit
Windowed volume, buy/sell counts and volumes, transactions and price change - 5m/1h/4h/6h/24h in one call.
The
24h window here is the exact same figure as stats24h on /v1/token - one 24h number across the whole product.Majors, stablecoins, wrapped natives and the native coin itself (
0x0000…0000 on EVM, 0xeeee…eeee accepted on input; the SOL mint on Solana) are served token-wide across every market they trade on. The native coin has no market of its own: its windows are the activity of its wrapped markets (WETH, WBNB…), as on stats24h of /v1/token.txns is the number of distinct transactions in the window, on every chain. buys/sells and buyVolumeNative/sellVolumeNative split flow by direction: on EVM they count swap events (a swap routed through several pools of the token counts one event per pool), on Solana they count transactions per side. uniqueBuyers/uniqueSellers are the unique wallets that bought / sold in the window. priceChangePct is the price change over the window, in percent. null when the window carries no priced trades.curl 'https://api.serialized.xyz/v1/token/stats?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/stats?chain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263' -H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/token/stats?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed&pools=0x0ca6485b7e9cf814a3fd09d81672b07323535b64&windows=1h,24h' -H 'Authorization: YOUR_API_KEY'
{
"data": {
"5m": {
"volumeNative": 0,
"volumeUsd": 0,
"buys": 0,
"sells": 0,
"txns": 0,
"buyVolumeNative": 0,
"sellVolumeNative": 0,
"priceChangePct": null
},
"1h": {
"volumeNative": 0.412094882336,
"volumeUsd": 775.71,
"buys": 4,
"sells": 2,
"txns": 6,
"buyVolumeNative": 0.398210102336,
"sellVolumeNative": 0.01388478,
"priceChangePct": 0.31844021
},
"6h": {
"volumeNative": 3.284880922336,
"volumeUsd": 6183.15,
"buys": 41,
"sells": 3,
"txns": 43,
"buyVolumeNative": 3.107442612402,
"sellVolumeNative": 0.177438309934,
"priceChangePct": 1.20455082
},
"24h": {
"volumeNative": 12.472824758820,
"volumeUsd": 23448.598725963,
"buys": 176,
"sells": 5,
"txns": 178,
"buyVolumeNative": 11.839201571847,
"sellVolumeNative": 0.633623186973,
"priceChangePct": 7.328276263872
}
},
"meta": {
"asOf": 1786725098444
}
}
{
"data": {
"1h": {
"volumeNative": 121.884073442,
"volumeUsd": 9160.42,
"buys": 388,
"sells": 402,
"buyVolumeNative": 61.402113,
"sellVolumeNative": 60.481960,
"txns": 784,
"priceChangePct": 0.492817
},
"24h": {
"volumeNative": 2466.120265838,
"volumeUsd": 185331.954920982,
"buys": 7534,
"sells": 8681,
"buyVolumeNative": 1244.830172419,
"sellVolumeNative": 1221.290093419,
"txns": 16108,
"priceChangePct": 3.636601730081
}
},
"meta": {
"asOf": 1786745258937
}
}
Authorizations
Your raw API key (not needed on the demo server).
Query Parameters
Public chain id.
Token address.
Optional CSV of pool addresses (≤50) to restrict the windows to; default token-wide (every pool of the token).
Comma-separated stat windows among 5m, 1h, 4h, 6h, 24h. Default: 5m,1h,6h,24h, the same default as /v1/pool/data.
Response
200
Standard { data, meta } envelope.