curl 'https://api.serialized.xyz/v1/token/pools?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "BRETT",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "127.33497008601",
"priceNative": "0.00000054747124708872",
"isLaunchpad": false,
"migrated": false,
"createdAt": 1705088299000,
"volume24hNative": 11.83920157,
"volume24hUsd": 22258.19,
"txns24h": 168
},
{
"address": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
"type": "UNISWAP_V3",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "BRETT",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "18.671634022943",
"priceNative": "0.00000054502089147879",
"isLaunchpad": false,
"migrated": false,
"createdAt": 1704655845000,
"volume24hNative": 0.63362319,
"volume24hUsd": 1191.19,
"txns24h": 13
}
],
"meta": {
"asOf": 1786724320416
}
}
Market & platform
Token Pools
The markets of a token - rank 1 is the exact pool the token endpoint prices from, then every other market ranked by 24h volume and liquidity.
GET
/
v1
/
token
/
pools
curl 'https://api.serialized.xyz/v1/token/pools?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "BRETT",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "127.33497008601",
"priceNative": "0.00000054747124708872",
"isLaunchpad": false,
"migrated": false,
"createdAt": 1705088299000,
"volume24hNative": 11.83920157,
"volume24hUsd": 22258.19,
"txns24h": 168
},
{
"address": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
"type": "UNISWAP_V3",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "BRETT",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "18.671634022943",
"priceNative": "0.00000054502089147879",
"isLaunchpad": false,
"migrated": false,
"createdAt": 1704655845000,
"volume24hNative": 0.63362319,
"volume24hUsd": 1191.19,
"txns24h": 13
}
],
"meta": {
"asOf": 1786724320416
}
}
GET /v1/token/pools · 1 credit
The markets of a token. Rank 1 is the token’s main market (the deepest pool where the token is the priced asset, measured on both sides of the pool: the exact pool the token endpoint prices from); the other markets follow, ranked by 24h volume then liquidity, so the most active markets come first. A token is listed on both sides of its markets: as the priced asset of a pool (side: "base") and on the markets where it is the quote asset (side: "quote"), which is how wrapped natives and stablecoins such as WETH, WHYPE or USDC trade.
Each row describes the pool from its own viewpoint:
baseAddress / baseSymbol is the pool’s priced asset, quoteAddress / quoteSymbol its quote asset, priceNative the price of the base asset in the chain’s native coin, and side tells you which of the two is the token you asked for. The token you asked for is always identified; the other side is null while its identity is still being resolved.Each pool carries its own 24h stats -
volume24hNative, volume24hUsd, txns24h (distinct transactions) - so you can pick the market to trade or price against. A pool without a trade over the last 24h reports measured zeros.priceNative and liquidityNative are null for a pool that has not traded yet. A pool whose price fell to zero after trading keeps priceNative "0".curl 'https://api.serialized.xyz/v1/token/pools?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "BRETT",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "127.33497008601",
"priceNative": "0.00000054747124708872",
"isLaunchpad": false,
"migrated": false,
"createdAt": 1705088299000,
"volume24hNative": 11.83920157,
"volume24hUsd": 22258.19,
"txns24h": 168
},
{
"address": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
"type": "UNISWAP_V3",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "BRETT",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "18.671634022943",
"priceNative": "0.00000054502089147879",
"isLaunchpad": false,
"migrated": false,
"createdAt": 1704655845000,
"volume24hNative": 0.63362319,
"volume24hUsd": 1191.19,
"txns24h": 13
}
],
"meta": {
"asOf": 1786724320416
}
}
Authorizations
Your raw API key (not needed on the demo server).
Query Parameters
Public chain id - evm:<id> or solana (solana:solana accepted).
Token address (EVM hex, case-insensitive).
1-100, default 50.
Required range:
1 <= x <= 100Response
200
Standard { data, meta } envelope.