curl 'https://api.serialized.xyz/v1/token/pools?chain=evm:8453&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"factoryAddress": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "DEGEN",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "127.33497008601",
"liquidityUsd": 239386.56038744663,
"pooledBase": "241032668.5124",
"pooledQuote": "127.33497008601",
"pooledBaseNative": "131.9590712398",
"pooledQuoteNative": "127.33497008601",
"priceNative": "0.00000054747124708872",
"isLaunchpad": false,
"isBondingCurve": false,
"migrated": false,
"migratedTo": null,
"migratedFrom": null,
"createdAt": 1705088299000,
"volume24hNative": 11.83920157,
"volume24hUsd": 22258.19,
"txns24h": 168,
"fees24hNative": 0.000507948,
"fees24hUsd": 0.954963
},
{
"address": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
"poolAddress": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
"type": "UNISWAP_V3",
"factory": null,
"factoryAddress": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "DEGEN",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "18.671634022943",
"liquidityUsd": 35102.67196138,
"pooledBase": "34259130.4471",
"pooledQuote": "18.671634022943",
"pooledBaseNative": "18.6719424381",
"pooledQuoteNative": "18.671634022943",
"priceNative": "0.00000054502089147879",
"isLaunchpad": false,
"isBondingCurve": false,
"migrated": false,
"migratedTo": null,
"migratedFrom": null,
"createdAt": 1704655845000,
"volume24hNative": 0.63362319,
"volume24hUsd": 1191.19,
"txns24h": 13,
"fees24hNative": 0.000030266,
"fees24hUsd": 0.056899
}
],
"meta": {
"asOf": 1786724320416
}
}
Tokens
Token Pools
The markets of a token - rank 1 is its main market, the exact pool the token endpoint prices from, then its other markets ranked the way the main market is picked (real depth, real trading, a trusted quote asset), then the rest 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",
"poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"factoryAddress": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "DEGEN",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "127.33497008601",
"liquidityUsd": 239386.56038744663,
"pooledBase": "241032668.5124",
"pooledQuote": "127.33497008601",
"pooledBaseNative": "131.9590712398",
"pooledQuoteNative": "127.33497008601",
"priceNative": "0.00000054747124708872",
"isLaunchpad": false,
"isBondingCurve": false,
"migrated": false,
"migratedTo": null,
"migratedFrom": null,
"createdAt": 1705088299000,
"volume24hNative": 11.83920157,
"volume24hUsd": 22258.19,
"txns24h": 168,
"fees24hNative": 0.000507948,
"fees24hUsd": 0.954963
},
{
"address": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
"poolAddress": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
"type": "UNISWAP_V3",
"factory": null,
"factoryAddress": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "DEGEN",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "18.671634022943",
"liquidityUsd": 35102.67196138,
"pooledBase": "34259130.4471",
"pooledQuote": "18.671634022943",
"pooledBaseNative": "18.6719424381",
"pooledQuoteNative": "18.671634022943",
"priceNative": "0.00000054502089147879",
"isLaunchpad": false,
"isBondingCurve": false,
"migrated": false,
"migratedTo": null,
"migratedFrom": null,
"createdAt": 1704655845000,
"volume24hNative": 0.63362319,
"volume24hUsd": 1191.19,
"txns24h": 13,
"fees24hNative": 0.000030266,
"fees24hUsd": 0.056899
}
],
"meta": {
"asOf": 1786724320416
}
}
GET /v1/token/pools · 1 credit
The markets of a token. Rank 1 is the token’s main market, the exact pool the token endpoint prices from: its launch curve while it trades there, then the market it graduated to, otherwise the market where the token trades best (real depth close to its price, real trading, a quote asset we trust). The other markets follow in the order of the same ranking: among the token’s deepest markets, the one that would take over as the main market comes second, and so on, so a market with real depth and real trading ranks ahead of one with a large but shallow volume. A market that stopped trading or is nearly empty leaves that ranking. The remaining markets come last, by 24h volume then liquidity. Every token is listed on the markets where it is the priced asset (side: "base"). On EVM chains it is also listed on its most active markets where it is the quote asset (side: "quote"), which is how wrapped natives and stablecoins such as WETH, WHYPE or USDC trade; on Solana, the quote-side rows are those of SOL (see below).
For a native coin (
0x0000…0000, 0xeeee…eeee, the wrapped native such as WETH or WBNB, the SOL mint), its USD markets come first (up to 10, the main one first: the market its candles follow), then its other markets, its most active markets quoted in the coin. These rows have side: "quote": the coin is the quote asset of those pools.address is the pool, and poolAddress repeats it (Identity fields): a row names no tokenAddress, since baseAddress and quoteAddress name both sides of the pool.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), fees24hNative and fees24hUsd - so you can pick the market to trade or price against. fees24hNative / fees24hUsd are the fees paid by the pool’s traders over the last 24h (network fees on EVM chains; network fees, validator tips and trading-terminal fees on Solana), in the chain’s native unit and in USD at the same rate as volume24hUsd: the feesNative / feesUsd of the 24h window of /v1/pool/data for that pool. A pool without a trade over the last 24h reports measured zeros.liquidityNative is each pool’s own liquidity and liquidityUsd its value at the current native price: on rank 1, the same two figures as pool.liquidityNative and pool.liquidityUsd of /v1/token. On a pool whose quote token has little real market of its own, the liquidity is capped by what that quote token can be sold for, on every surface. The token’s liquidity on /v1/token sums its most traded markets, each counted on its smaller side, so it is not the sum of this column.pooledBase and pooledQuote are what sits in each pool: the amounts of its base and quote assets, in token units (decimal-adjusted). pooledBaseNative values the base side at the pool’s own price, pooledQuoteNative the quote side as the pool’s liquidity counts it (capped like liquidityNative). A side worth nothing reads "0"; a side that cannot be priced is null. All four are null on a launch curve (its reserves follow the launchpad’s own accounting), when the indexed reserves of a concentrated-liquidity pool are not reliable (a negative running total), and before the pool ever held anything. They are the pool.pooled* fields of /v1/token and the fields of /v1/pool for the same pool.factoryAddress is the on-chain address that created each pool, the pool.factoryAddress of /v1/token on every row: the pair factory on EVM chains (the PoolManager on Uniswap V4 and its forks), the program of the pool’s own venue on Solana. It names the pool’s venue, never the token’s launchpad: on a token that graduated from pump.fun, the PumpSwap row carries PumpSwap’s program (pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA) and the curve row pump.fun’s (6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P). factory keeps naming the launchpad. null when unknown.isLaunchpad and migrated are each pool’s launchpad state, the same values as on /v1/pool: isLaunchpad is true on a bonding curve and on the pool that a launchpad with no bonding curve (Clanker, Bankr, Zora…) launches its tokens straight into; migrated is true once that pool graduated (its curve migrated to a new pool or completed in place, or the launchpad’s liquidity or market cap goal was reached).isBondingCurve, migratedTo and migratedFrom are the same values as on /v1/pool for every pool of the list: isBondingCurve is true on a launchpad’s bonding curve; migratedTo is the pool a migrated bonding curve migrated to, migratedFrom the bonding curve of the pool a migration landed in, both null on every other pool. On a token that graduated from a bonding curve, the curve’s row and its destination’s row name each other.priceNative, liquidityNative and liquidityUsd 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",
"poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"factoryAddress": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "DEGEN",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "127.33497008601",
"liquidityUsd": 239386.56038744663,
"pooledBase": "241032668.5124",
"pooledQuote": "127.33497008601",
"pooledBaseNative": "131.9590712398",
"pooledQuoteNative": "127.33497008601",
"priceNative": "0.00000054747124708872",
"isLaunchpad": false,
"isBondingCurve": false,
"migrated": false,
"migratedTo": null,
"migratedFrom": null,
"createdAt": 1705088299000,
"volume24hNative": 11.83920157,
"volume24hUsd": 22258.19,
"txns24h": 168,
"fees24hNative": 0.000507948,
"fees24hUsd": 0.954963
},
{
"address": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
"poolAddress": "0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa",
"type": "UNISWAP_V3",
"factory": null,
"factoryAddress": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"side": "base",
"baseAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"baseSymbol": "DEGEN",
"quoteAddress": "0x4200000000000000000000000000000000000006",
"quoteSymbol": "WETH",
"liquidityNative": "18.671634022943",
"liquidityUsd": 35102.67196138,
"pooledBase": "34259130.4471",
"pooledQuote": "18.671634022943",
"pooledBaseNative": "18.6719424381",
"pooledQuoteNative": "18.671634022943",
"priceNative": "0.00000054502089147879",
"isLaunchpad": false,
"isBondingCurve": false,
"migrated": false,
"migratedTo": null,
"migratedFrom": null,
"createdAt": 1704655845000,
"volume24hNative": 0.63362319,
"volume24hUsd": 1191.19,
"txns24h": 13,
"fees24hNative": 0.000030266,
"fees24hUsd": 0.056899
}
],
"meta": {
"asOf": 1786724320416
}
}
Query Parameters
Response
200
Standard { data, meta } envelope.