curl -X POST 'https://api.serialized.xyz/v1/pool' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"chain":"evm:8453","address":"0x0ca6485b7e9cf814a3fd09d81672b07323535b64"},{"chain":"solana","address":"58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"},{"chain":"evm:8453","address":"0x00000000000000000000000000000000deadbeef"}]}'
{
"data": [
{
"data": {
"chain": "evm:8453",
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"feeBps": 100,
"token": {
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"totalSupply": "36189963032.46508"
},
"quote": {
"address": "0x4200000000000000000000000000000000000006",
"symbol": "WETH"
},
"priceNative": "0.00000042875744501546",
"liquidityNative": "98.708436808261",
"isLaunchpad": false,
"bondingProgress": null,
"migrated": false,
"createdAt": 1705088299000
}
},
{
"data": {
"chain": "solana",
"address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
"type": "RAYDIUM_AMM_V4",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Raydium",
"logo": "https://serialized.cloud/logos/dex/raydium.7e076570.webp"
},
"feeBps": 25,
"token": {
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"name": "USD Coin",
"symbol": "USDC",
"decimals": 6,
"totalSupply": "8003434199.826001"
},
"quote": {
"address": "So11111111111111111111111111111111111111112",
"symbol": "SOL"
},
"priceNative": "0.009993169860651512",
"liquidityNative": "128982.611397012",
"isLaunchpad": false,
"bondingProgress": null,
"migrated": false,
"createdAt": 1629277935000
}
},
{
"error": {
"code": "NOT_FOUND",
"message": "Pool 0x00000000000000000000000000000000deadbeef on evm:8453 not found"
}
}
],
"meta": {
"asOf": 1789076973417
}
}
Market Definition
Market Definition: batch
Batch twin: the static definition of up to 100 markets in one call, across chains. Response in input order, one slot per market, billed per market.
POST
/
v1
/
pool
curl -X POST 'https://api.serialized.xyz/v1/pool' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"chain":"evm:8453","address":"0x0ca6485b7e9cf814a3fd09d81672b07323535b64"},{"chain":"solana","address":"58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"},{"chain":"evm:8453","address":"0x00000000000000000000000000000000deadbeef"}]}'
{
"data": [
{
"data": {
"chain": "evm:8453",
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"feeBps": 100,
"token": {
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"totalSupply": "36189963032.46508"
},
"quote": {
"address": "0x4200000000000000000000000000000000000006",
"symbol": "WETH"
},
"priceNative": "0.00000042875744501546",
"liquidityNative": "98.708436808261",
"isLaunchpad": false,
"bondingProgress": null,
"migrated": false,
"createdAt": 1705088299000
}
},
{
"data": {
"chain": "solana",
"address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
"type": "RAYDIUM_AMM_V4",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Raydium",
"logo": "https://serialized.cloud/logos/dex/raydium.7e076570.webp"
},
"feeBps": 25,
"token": {
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"name": "USD Coin",
"symbol": "USDC",
"decimals": 6,
"totalSupply": "8003434199.826001"
},
"quote": {
"address": "So11111111111111111111111111111111111111112",
"symbol": "SOL"
},
"priceNative": "0.009993169860651512",
"liquidityNative": "128982.611397012",
"isLaunchpad": false,
"bondingProgress": null,
"migrated": false,
"createdAt": 1629277935000
}
},
{
"error": {
"code": "NOT_FOUND",
"message": "Pool 0x00000000000000000000000000000000deadbeef on evm:8453 not found"
}
}
],
"meta": {
"asOf": 1789076973417
}
}
POST /v1/pool · 1 per market credit
Batch twin: the static definition of up to 100 {chain, address} markets in one call, EVM and Solana mixed freely. The response comes back 200 in input order, one slot per market: { data }, exactly the body of GET /v1/pool for that market, or { error: { code, message } } for that market alone (unknown pool, malformed address), never null. One bad market never costs you the rest of the lot. Billed per market.
Definitions are slow-changing, so a lot you poll comes back from cache after the first call; the single GET and the batch share it.
A slot’s
data is exactly what GET /v1/pool returns for that market: venue/type, launchpad or factory of origin, feeBps, base and quote token metadata, priceNative, liquidityNative, launchpad and bonding state, createdAt; see that page for the field rules.curl -X POST 'https://api.serialized.xyz/v1/pool' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"items":[{"chain":"evm:8453","address":"0x0ca6485b7e9cf814a3fd09d81672b07323535b64"},{"chain":"solana","address":"58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"},{"chain":"evm:8453","address":"0x00000000000000000000000000000000deadbeef"}]}'
{
"data": [
{
"data": {
"chain": "evm:8453",
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64",
"type": "UNISWAP_V3",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Uniswap V3",
"logo": "https://serialized.cloud/logos/dex/uniswap.680e6da3.svg"
},
"feeBps": 100,
"token": {
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"name": "Degen",
"symbol": "DEGEN",
"decimals": 18,
"totalSupply": "36189963032.46508"
},
"quote": {
"address": "0x4200000000000000000000000000000000000006",
"symbol": "WETH"
},
"priceNative": "0.00000042875744501546",
"liquidityNative": "98.708436808261",
"isLaunchpad": false,
"bondingProgress": null,
"migrated": false,
"createdAt": 1705088299000
}
},
{
"data": {
"chain": "solana",
"address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
"type": "RAYDIUM_AMM_V4",
"factory": null,
"launchpad": null,
"exchange": {
"name": "Raydium",
"logo": "https://serialized.cloud/logos/dex/raydium.7e076570.webp"
},
"feeBps": 25,
"token": {
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"name": "USD Coin",
"symbol": "USDC",
"decimals": 6,
"totalSupply": "8003434199.826001"
},
"quote": {
"address": "So11111111111111111111111111111111111111112",
"symbol": "SOL"
},
"priceNative": "0.009993169860651512",
"liquidityNative": "128982.611397012",
"isLaunchpad": false,
"bondingProgress": null,
"migrated": false,
"createdAt": 1629277935000
}
},
{
"error": {
"code": "NOT_FOUND",
"message": "Pool 0x00000000000000000000000000000000deadbeef on evm:8453 not found"
}
}
],
"meta": {
"asOf": 1789076973417
}
}
Authorizations
Your raw API key (not needed on the demo server).
Body
application/json
[{ "chain": "…", "address": "…" }] - 1 to 100 markets (pool addresses, Uniswap V4 poolIds supported), EVM and Solana mixed freely.
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Example:
[
{
"chain": "evm:8453",
"address": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64"
},
{
"chain": "solana",
"address": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"
}
]
Response
200
Standard { data, meta } envelope.