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,
"buyVolumeUsd": 0,
"sellVolumeUsd": 0,
"buys": 0,
"sells": 0,
"txns": 0,
"buyVolumeNative": 0,
"sellVolumeNative": 0,
"uniqueBuyers": 0,
"uniqueSellers": 0,
"traders": 0,
"feesNative": 0,
"feesUsd": 0,
"priceChangePct": null
},
"1h": {
"volumeNative": 0.412094882336,
"volumeUsd": 775.71,
"buyVolumeUsd": 749.57,
"sellVolumeUsd": 26.14,
"buys": 4,
"sells": 2,
"txns": 6,
"buyVolumeNative": 0.398210102336,
"sellVolumeNative": 0.01388478,
"uniqueBuyers": 4,
"uniqueSellers": 2,
"traders": 5,
"feesNative": 0.000017843,
"feesUsd": 0.033587,
"priceChangePct": 0.31844021
},
"6h": {
"volumeNative": 3.284880922336,
"volumeUsd": 6183.15,
"buyVolumeUsd": 5849.16,
"sellVolumeUsd": 333.99,
"buys": 41,
"sells": 3,
"txns": 43,
"buyVolumeNative": 3.107442612402,
"sellVolumeNative": 0.177438309934,
"uniqueBuyers": 33,
"uniqueSellers": 3,
"traders": 35,
"feesNative": 0.000131402,
"feesUsd": 0.247339,
"priceChangePct": 1.20455082
},
"24h": {
"volumeNative": 12.472824758820,
"volumeUsd": 23448.598725963,
"buyVolumeUsd": 22257.4,
"sellVolumeUsd": 1191.2,
"buys": 176,
"sells": 5,
"txns": 178,
"buyVolumeNative": 11.839201571847,
"sellVolumeNative": 0.633623186973,
"uniqueBuyers": 141,
"uniqueSellers": 5,
"traders": 143,
"feesNative": 0.000538214,
"feesUsd": 1.011829,
"priceChangePct": 7.328276263872
}
},
"meta": {
"asOf": 1786725098444
}
}
{
"data": {
"1h": {
"volumeNative": 121.884073442,
"volumeUsd": 9160.42,
"buyVolumeUsd": 4614.79,
"sellVolumeUsd": 4545.63,
"buys": 388,
"sells": 402,
"buyVolumeNative": 61.402113,
"sellVolumeNative": 60.481960,
"txns": 784,
"uniqueBuyers": 124,
"uniqueSellers": 161,
"priceChangePct": 0.492817,
"traders": 233,
"feesNative": 0.311806524,
"feesUsd": 23.434388
},
"24h": {
"volumeNative": 2466.120265838,
"volumeUsd": 185331.954920982,
"buyVolumeUsd": 93550.51,
"sellVolumeUsd": 91781.44,
"buys": 7534,
"sells": 8681,
"buyVolumeNative": 1244.830172419,
"sellVolumeNative": 1221.290093419,
"txns": 16108,
"uniqueBuyers": 2104,
"uniqueSellers": 2630,
"priceChangePct": 3.636601730081,
"traders": 3877,
"feesNative": 6.284117392,
"feesUsd": 472.25911
}
},
"meta": {
"asOf": 1786745258937
}
}
Token Stats
Token Stats
Windowed volume, buy/sell counts and volumes, transactions, unique traders, fees paid and price change - 5m/1h/6h/24h in one call by default, 1m, 15m, 30m, 4h and 12h on request. 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,
"buyVolumeUsd": 0,
"sellVolumeUsd": 0,
"buys": 0,
"sells": 0,
"txns": 0,
"buyVolumeNative": 0,
"sellVolumeNative": 0,
"uniqueBuyers": 0,
"uniqueSellers": 0,
"traders": 0,
"feesNative": 0,
"feesUsd": 0,
"priceChangePct": null
},
"1h": {
"volumeNative": 0.412094882336,
"volumeUsd": 775.71,
"buyVolumeUsd": 749.57,
"sellVolumeUsd": 26.14,
"buys": 4,
"sells": 2,
"txns": 6,
"buyVolumeNative": 0.398210102336,
"sellVolumeNative": 0.01388478,
"uniqueBuyers": 4,
"uniqueSellers": 2,
"traders": 5,
"feesNative": 0.000017843,
"feesUsd": 0.033587,
"priceChangePct": 0.31844021
},
"6h": {
"volumeNative": 3.284880922336,
"volumeUsd": 6183.15,
"buyVolumeUsd": 5849.16,
"sellVolumeUsd": 333.99,
"buys": 41,
"sells": 3,
"txns": 43,
"buyVolumeNative": 3.107442612402,
"sellVolumeNative": 0.177438309934,
"uniqueBuyers": 33,
"uniqueSellers": 3,
"traders": 35,
"feesNative": 0.000131402,
"feesUsd": 0.247339,
"priceChangePct": 1.20455082
},
"24h": {
"volumeNative": 12.472824758820,
"volumeUsd": 23448.598725963,
"buyVolumeUsd": 22257.4,
"sellVolumeUsd": 1191.2,
"buys": 176,
"sells": 5,
"txns": 178,
"buyVolumeNative": 11.839201571847,
"sellVolumeNative": 0.633623186973,
"uniqueBuyers": 141,
"uniqueSellers": 5,
"traders": 143,
"feesNative": 0.000538214,
"feesUsd": 1.011829,
"priceChangePct": 7.328276263872
}
},
"meta": {
"asOf": 1786725098444
}
}
{
"data": {
"1h": {
"volumeNative": 121.884073442,
"volumeUsd": 9160.42,
"buyVolumeUsd": 4614.79,
"sellVolumeUsd": 4545.63,
"buys": 388,
"sells": 402,
"buyVolumeNative": 61.402113,
"sellVolumeNative": 60.481960,
"txns": 784,
"uniqueBuyers": 124,
"uniqueSellers": 161,
"priceChangePct": 0.492817,
"traders": 233,
"feesNative": 0.311806524,
"feesUsd": 23.434388
},
"24h": {
"volumeNative": 2466.120265838,
"volumeUsd": 185331.954920982,
"buyVolumeUsd": 93550.51,
"sellVolumeUsd": 91781.44,
"buys": 7534,
"sells": 8681,
"buyVolumeNative": 1244.830172419,
"sellVolumeNative": 1221.290093419,
"txns": 16108,
"uniqueBuyers": 2104,
"uniqueSellers": 2630,
"priceChangePct": 3.636601730081,
"traders": 3877,
"feesNative": 6.284117392,
"feesUsd": 472.25911
}
},
"meta": {
"asOf": 1786745258937
}
}
GET /v1/token/stats · 2 credits
Live: the
token-updates stream channel with windows pushes these windows as they move.5m/1h/6h/24h in one call by default; pick any of 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 24h with windows. The same blocks come with the token itself on /v1/token when you pass windows there.
The
1m window covers the last 60 seconds, with the fields of the other windows. Ask for it by name: it is never part of the default. It is null when it is not known yet, never a made-up 0; a block of zeros means nobody traded in the last 60 seconds. It is served token-wide or for one pool: with pools listing several pools it is null. On majors, stablecoins and wrapped natives it carries the price change only, when there is one (null on wrapped natives and on USD stablecoins of EVM chains); on a native coin it is null. For a continuous feed of the same window, subscribe to the token-updates stream.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, 0x0000…0000 and 0xeeee…eeee accepted too) are served token-wide across every market they trade on. The native coin’s windows include the activity of its wrapped form (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 (buyVolumeUsd/sellVolumeUsd: the two sides in USD, at the same rate as volumeUsd): 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. traders is the number of unique wallets that bought or sold in the window, each wallet counted once across the token’s pools (null on majors, stablecoins, wrapped natives and native coins). feesNative and feesUsd are the fees paid by traders in the window (network fees on EVM chains; network fees, validator tips and trading-terminal fees on Solana), summed over the token’s pools (a transaction routed through two of them counts in each): feesNative in the chain’s native unit, feesUsd at the same rate as volumeUsd (both null on majors, stablecoins, wrapped natives and native coins). priceChangePct is the price change over the window, in percent, on the token’s main market (its launch curve included before graduation): the market of the price and the candles. With pools, the volumes, counts and fees cover the pools you list, and the price change follows the main market when you list it, otherwise the first pool you list. 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,
"buyVolumeUsd": 0,
"sellVolumeUsd": 0,
"buys": 0,
"sells": 0,
"txns": 0,
"buyVolumeNative": 0,
"sellVolumeNative": 0,
"uniqueBuyers": 0,
"uniqueSellers": 0,
"traders": 0,
"feesNative": 0,
"feesUsd": 0,
"priceChangePct": null
},
"1h": {
"volumeNative": 0.412094882336,
"volumeUsd": 775.71,
"buyVolumeUsd": 749.57,
"sellVolumeUsd": 26.14,
"buys": 4,
"sells": 2,
"txns": 6,
"buyVolumeNative": 0.398210102336,
"sellVolumeNative": 0.01388478,
"uniqueBuyers": 4,
"uniqueSellers": 2,
"traders": 5,
"feesNative": 0.000017843,
"feesUsd": 0.033587,
"priceChangePct": 0.31844021
},
"6h": {
"volumeNative": 3.284880922336,
"volumeUsd": 6183.15,
"buyVolumeUsd": 5849.16,
"sellVolumeUsd": 333.99,
"buys": 41,
"sells": 3,
"txns": 43,
"buyVolumeNative": 3.107442612402,
"sellVolumeNative": 0.177438309934,
"uniqueBuyers": 33,
"uniqueSellers": 3,
"traders": 35,
"feesNative": 0.000131402,
"feesUsd": 0.247339,
"priceChangePct": 1.20455082
},
"24h": {
"volumeNative": 12.472824758820,
"volumeUsd": 23448.598725963,
"buyVolumeUsd": 22257.4,
"sellVolumeUsd": 1191.2,
"buys": 176,
"sells": 5,
"txns": 178,
"buyVolumeNative": 11.839201571847,
"sellVolumeNative": 0.633623186973,
"uniqueBuyers": 141,
"uniqueSellers": 5,
"traders": 143,
"feesNative": 0.000538214,
"feesUsd": 1.011829,
"priceChangePct": 7.328276263872
}
},
"meta": {
"asOf": 1786725098444
}
}
{
"data": {
"1h": {
"volumeNative": 121.884073442,
"volumeUsd": 9160.42,
"buyVolumeUsd": 4614.79,
"sellVolumeUsd": 4545.63,
"buys": 388,
"sells": 402,
"buyVolumeNative": 61.402113,
"sellVolumeNative": 60.481960,
"txns": 784,
"uniqueBuyers": 124,
"uniqueSellers": 161,
"priceChangePct": 0.492817,
"traders": 233,
"feesNative": 0.311806524,
"feesUsd": 23.434388
},
"24h": {
"volumeNative": 2466.120265838,
"volumeUsd": 185331.954920982,
"buyVolumeUsd": 93550.51,
"sellVolumeUsd": 91781.44,
"buys": 7534,
"sells": 8681,
"buyVolumeNative": 1244.830172419,
"sellVolumeNative": 1221.290093419,
"txns": 16108,
"uniqueBuyers": 2104,
"uniqueSellers": 2630,
"priceChangePct": 3.636601730081,
"traders": 3877,
"feesNative": 6.284117392,
"feesUsd": 472.25911
}
},
"meta": {
"asOf": 1786745258937
}
}
Query Parameters
Response
200
Standard { data, meta } envelope.