Multiple Pools Data by Pool Addresses
curl --request GET \
--url https://api.coingecko.com/api/v3/onchain/networks/{network}/pools/multi/{addresses} \
--header 'x-cg-demo-api-key: <api-key>'{
"data": [
{
"id": "solana_E6RbuozUjZshXH3sRKgCaoXPzfc7EMFiyu4HRxf6ERrH",
"type": "pool",
"attributes": {
"base_token_price_usd": "0.00006785892126",
"base_token_price_native_currency": "0.000000402213205044735",
"base_token_balance": "1716982.45439",
"base_token_liquidity_usd": "112.4827161348525458017941976304612125873344",
"quote_token_price_usd": "166.1681210425",
"quote_token_price_native_currency": "1.0",
"quote_token_balance": "84.304187317",
"quote_token_liquidity_usd": "13731.33488386283090412937487797736",
"base_token_price_quote_token": "0.000000402213205",
"quote_token_price_base_token": "2486243.58289972",
"address": "E6RbuozUjZshXH3sRKgCaoXPzfc7EMFiyu4HRxf6ERrH",
"name": "WOJAK / SOL",
"pool_name": "WOJAK / SOL",
"pool_fee_percentage": null,
"pool_created_at": "2025-11-03T00:11:28Z",
"fdv_usd": "67858.2887710887",
"market_cap_usd": "67848.4847322741",
"price_change_percentage": {
"m5": "0",
"m15": "0",
"m30": "0",
"h1": "0",
"h6": "0",
"h24": "0"
},
"transactions": {
"m5": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"m15": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"m30": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"h1": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"h6": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"h24": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
}
},
"volume_usd": {
"m5": "0.0",
"m15": "0.0",
"m30": "0.0",
"h1": "0.0",
"h6": "0.0",
"h24": "0.0"
},
"net_buy_volume_usd": {
"m5": "0.0",
"m15": "0.0",
"m30": "0.0",
"h1": "0.0",
"h6": "0.0",
"h24": "0.0"
},
"buy_volume_usd": {
"m5": "0.0",
"m15": "0.0",
"m30": "0.0",
"h1": "0.0",
"h6": "0.0",
"h24": "0.0"
},
"sell_volume_usd": {
"m5": "0.0",
"m15": "0.0",
"m30": "0.0",
"h1": "0.0",
"h6": "0.0",
"h24": "0.0"
},
"reserve_in_usd": "13843.8176",
"locked_liquidity_percentage": null,
"launchpad_details": {
"graduation_percentage": 100,
"completed": true,
"completed_at": "2025-11-03T20:41:29.000Z",
"migrated_destination_pool_address": "FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7"
}
},
"relationships": {
"base_token": {
"data": {
"id": "solana_8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
"type": "token"
}
},
"quote_token": {
"data": {
"id": "solana_So11111111111111111111111111111111111111112",
"type": "token"
}
},
"dex": {
"data": {
"id": "pump-fun",
"type": "dex"
}
}
}
},
{
"id": "solana_5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"type": "pool",
"attributes": {
"base_token_price_usd": "0.00000373387120582149930598911545945444530201826081",
"base_token_price_native_currency": "0.0000000314001994769456",
"base_token_balance": "74575800617.6894",
"base_token_liquidity_usd": "279090.6252750916369084859895287442940709577512786812749",
"quote_token_price_usd": "118.918433400965066763549895423",
"quote_token_price_native_currency": "1.0",
"quote_token_balance": "1225.627745771",
"quote_token_liquidity_usd": "146074.1948249083692026119455827287906235410158",
"base_token_price_quote_token": "0.00000003140019948",
"quote_token_price_base_token": "31846931.441764",
"address": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"name": "Bonk / SOL",
"pool_name": "Bonk / SOL",
"pool_fee_percentage": null,
"pool_created_at": "2023-07-05T14:41:09Z",
"fdv_usd": "328559674.843403",
"market_cap_usd": "328559674.843402",
"price_change_percentage": {
"m5": "-0.102",
"m15": "-0.556",
"m30": "0.969",
"h1": "1.796",
"h6": "0.518",
"h24": "10.512"
},
"transactions": {
"m5": {
"buys": 2,
"sells": 19,
"buyers": 2,
"sellers": 17
},
"m15": {
"buys": 40,
"sells": 120,
"buyers": 23,
"sellers": 64
},
"m30": {
"buys": 112,
"sells": 348,
"buyers": 35,
"sellers": 118
},
"h1": {
"buys": 232,
"sells": 563,
"buyers": 59,
"sellers": 182
},
"h6": {
"buys": 1694,
"sells": 2048,
"buyers": 523,
"sellers": 761
},
"h24": {
"buys": 10406,
"sells": 12475,
"buyers": 2051,
"sellers": 2717
}
},
"volume_usd": {
"m5": "898.7386475827",
"m15": "6335.891732359",
"m30": "17308.6495362377",
"h1": "28716.9843463603",
"h6": "162171.587115052",
"h24": "1198448.83285705"
},
"net_buy_volume_usd": {
"m5": "-90.8438050183",
"m15": "-1201.5441254113",
"m30": "4283.791512253",
"h1": "9661.9962903805",
"h6": "3630.6500896265",
"h24": "35605.434484744"
},
"buy_volume_usd": {
"m5": "403.9474212822",
"m15": "2567.1738034739",
"m30": "10796.2205242453",
"h1": "19189.4903183704",
"h6": "82901.1186023391",
"h24": "617027.133670897"
},
"sell_volume_usd": {
"m5": "494.7912263005",
"m15": "3768.7179288852",
"m30": "6512.4290119923",
"h1": "9527.4940279899",
"h6": "79270.4685127126",
"h24": "581421.699186153"
},
"reserve_in_usd": "425164.8201",
"locked_liquidity_percentage": "0.0"
},
"relationships": {
"base_token": {
"data": {
"id": "solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"type": "token"
}
},
"quote_token": {
"data": {
"id": "solana_So11111111111111111111111111111111111111112",
"type": "token"
}
},
"dex": {
"data": {
"id": "orca",
"type": "dex"
}
}
}
}
],
"included": [
{
"id": "solana_8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
"type": "token",
"attributes": {
"address": "8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
"name": "Wojak",
"symbol": "WOJAK",
"decimals": 6,
"image_url": "https://coin-images.coingecko.com/coins/images/70552/large/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550",
"coingecko_coin_id": "wojak-4"
}
},
{
"id": "solana_So11111111111111111111111111111111111111112",
"type": "token",
"attributes": {
"address": "So11111111111111111111111111111111111111112",
"name": "Wrapped SOL",
"symbol": "SOL",
"decimals": 9,
"image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989",
"coingecko_coin_id": "wrapped-solana"
}
},
{
"id": "pump-fun",
"type": "dex",
"attributes": {
"name": "Pump.fun"
}
},
{
"id": "solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"type": "token",
"attributes": {
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"name": "Bonk",
"symbol": "Bonk",
"decimals": 5,
"image_url": "https://coin-images.coingecko.com/coins/images/28600/large/bonk.jpg?1696527587",
"coingecko_coin_id": "bonk"
}
},
{
"id": "orca",
"type": "dex",
"attributes": {
"name": "Orca"
}
}
]
}Multiple Pools Data by Pool Addresses
To query multiple pools based on the provided network and pool addresses
GET
/
onchain
/
networks
/
{network}
/
pools
/
multi
/
{addresses}
Multiple Pools Data by Pool Addresses
curl --request GET \
--url https://api.coingecko.com/api/v3/onchain/networks/{network}/pools/multi/{addresses} \
--header 'x-cg-demo-api-key: <api-key>'{
"data": [
{
"id": "solana_E6RbuozUjZshXH3sRKgCaoXPzfc7EMFiyu4HRxf6ERrH",
"type": "pool",
"attributes": {
"base_token_price_usd": "0.00006785892126",
"base_token_price_native_currency": "0.000000402213205044735",
"base_token_balance": "1716982.45439",
"base_token_liquidity_usd": "112.4827161348525458017941976304612125873344",
"quote_token_price_usd": "166.1681210425",
"quote_token_price_native_currency": "1.0",
"quote_token_balance": "84.304187317",
"quote_token_liquidity_usd": "13731.33488386283090412937487797736",
"base_token_price_quote_token": "0.000000402213205",
"quote_token_price_base_token": "2486243.58289972",
"address": "E6RbuozUjZshXH3sRKgCaoXPzfc7EMFiyu4HRxf6ERrH",
"name": "WOJAK / SOL",
"pool_name": "WOJAK / SOL",
"pool_fee_percentage": null,
"pool_created_at": "2025-11-03T00:11:28Z",
"fdv_usd": "67858.2887710887",
"market_cap_usd": "67848.4847322741",
"price_change_percentage": {
"m5": "0",
"m15": "0",
"m30": "0",
"h1": "0",
"h6": "0",
"h24": "0"
},
"transactions": {
"m5": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"m15": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"m30": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"h1": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"h6": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
},
"h24": {
"buys": 0,
"sells": 0,
"buyers": 0,
"sellers": 0
}
},
"volume_usd": {
"m5": "0.0",
"m15": "0.0",
"m30": "0.0",
"h1": "0.0",
"h6": "0.0",
"h24": "0.0"
},
"net_buy_volume_usd": {
"m5": "0.0",
"m15": "0.0",
"m30": "0.0",
"h1": "0.0",
"h6": "0.0",
"h24": "0.0"
},
"buy_volume_usd": {
"m5": "0.0",
"m15": "0.0",
"m30": "0.0",
"h1": "0.0",
"h6": "0.0",
"h24": "0.0"
},
"sell_volume_usd": {
"m5": "0.0",
"m15": "0.0",
"m30": "0.0",
"h1": "0.0",
"h6": "0.0",
"h24": "0.0"
},
"reserve_in_usd": "13843.8176",
"locked_liquidity_percentage": null,
"launchpad_details": {
"graduation_percentage": 100,
"completed": true,
"completed_at": "2025-11-03T20:41:29.000Z",
"migrated_destination_pool_address": "FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7"
}
},
"relationships": {
"base_token": {
"data": {
"id": "solana_8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
"type": "token"
}
},
"quote_token": {
"data": {
"id": "solana_So11111111111111111111111111111111111111112",
"type": "token"
}
},
"dex": {
"data": {
"id": "pump-fun",
"type": "dex"
}
}
}
},
{
"id": "solana_5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"type": "pool",
"attributes": {
"base_token_price_usd": "0.00000373387120582149930598911545945444530201826081",
"base_token_price_native_currency": "0.0000000314001994769456",
"base_token_balance": "74575800617.6894",
"base_token_liquidity_usd": "279090.6252750916369084859895287442940709577512786812749",
"quote_token_price_usd": "118.918433400965066763549895423",
"quote_token_price_native_currency": "1.0",
"quote_token_balance": "1225.627745771",
"quote_token_liquidity_usd": "146074.1948249083692026119455827287906235410158",
"base_token_price_quote_token": "0.00000003140019948",
"quote_token_price_base_token": "31846931.441764",
"address": "5zpyutJu9ee6jFymDGoK7F6S5Kczqtc9FomP3ueKuyA9",
"name": "Bonk / SOL",
"pool_name": "Bonk / SOL",
"pool_fee_percentage": null,
"pool_created_at": "2023-07-05T14:41:09Z",
"fdv_usd": "328559674.843403",
"market_cap_usd": "328559674.843402",
"price_change_percentage": {
"m5": "-0.102",
"m15": "-0.556",
"m30": "0.969",
"h1": "1.796",
"h6": "0.518",
"h24": "10.512"
},
"transactions": {
"m5": {
"buys": 2,
"sells": 19,
"buyers": 2,
"sellers": 17
},
"m15": {
"buys": 40,
"sells": 120,
"buyers": 23,
"sellers": 64
},
"m30": {
"buys": 112,
"sells": 348,
"buyers": 35,
"sellers": 118
},
"h1": {
"buys": 232,
"sells": 563,
"buyers": 59,
"sellers": 182
},
"h6": {
"buys": 1694,
"sells": 2048,
"buyers": 523,
"sellers": 761
},
"h24": {
"buys": 10406,
"sells": 12475,
"buyers": 2051,
"sellers": 2717
}
},
"volume_usd": {
"m5": "898.7386475827",
"m15": "6335.891732359",
"m30": "17308.6495362377",
"h1": "28716.9843463603",
"h6": "162171.587115052",
"h24": "1198448.83285705"
},
"net_buy_volume_usd": {
"m5": "-90.8438050183",
"m15": "-1201.5441254113",
"m30": "4283.791512253",
"h1": "9661.9962903805",
"h6": "3630.6500896265",
"h24": "35605.434484744"
},
"buy_volume_usd": {
"m5": "403.9474212822",
"m15": "2567.1738034739",
"m30": "10796.2205242453",
"h1": "19189.4903183704",
"h6": "82901.1186023391",
"h24": "617027.133670897"
},
"sell_volume_usd": {
"m5": "494.7912263005",
"m15": "3768.7179288852",
"m30": "6512.4290119923",
"h1": "9527.4940279899",
"h6": "79270.4685127126",
"h24": "581421.699186153"
},
"reserve_in_usd": "425164.8201",
"locked_liquidity_percentage": "0.0"
},
"relationships": {
"base_token": {
"data": {
"id": "solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"type": "token"
}
},
"quote_token": {
"data": {
"id": "solana_So11111111111111111111111111111111111111112",
"type": "token"
}
},
"dex": {
"data": {
"id": "orca",
"type": "dex"
}
}
}
}
],
"included": [
{
"id": "solana_8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
"type": "token",
"attributes": {
"address": "8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
"name": "Wojak",
"symbol": "WOJAK",
"decimals": 6,
"image_url": "https://coin-images.coingecko.com/coins/images/70552/large/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550",
"coingecko_coin_id": "wojak-4"
}
},
{
"id": "solana_So11111111111111111111111111111111111111112",
"type": "token",
"attributes": {
"address": "So11111111111111111111111111111111111111112",
"name": "Wrapped SOL",
"symbol": "SOL",
"decimals": 9,
"image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989",
"coingecko_coin_id": "wrapped-solana"
}
},
{
"id": "pump-fun",
"type": "dex",
"attributes": {
"name": "Pump.fun"
}
},
{
"id": "solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"type": "token",
"attributes": {
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"name": "Bonk",
"symbol": "Bonk",
"decimals": 5,
"image_url": "https://coin-images.coingecko.com/coins/images/28600/large/bonk.jpg?1696527587",
"coingecko_coin_id": "bonk"
}
},
{
"id": "orca",
"type": "dex",
"attributes": {
"name": "Orca"
}
}
]
}Notes
- Addresses not found in GeckoTerminal will be ignored.
- Supports up to 30 pool addresses per request. Analyst plan or above supports up to 50.
- Unverified token market cap returns
null— the displayed value on GeckoTerminal may match FDV and might not be accurate. Verified market cap is sourced from CoinGecko and may exceed FDV if it includes tokens on other networks. - Use
includeto return related attributes under the top-levelincludedkey. locked_liquidity_percentageis updated daily.- Set
include_composition=trueto surface balance and liquidity of base and quote tokens. - Bonding curve pools (non-graduated launchpad pools) return a
launchpad_detailsobject with graduation status.
SDK Examples
New to the SDK? Install and authenticate theclient first:TypeScript | Python
const response = await client.onchain.networks.pools.multi.getAddresses('0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640', {
network: 'eth',
});
console.log(JSON.stringify(response, null, 2));
response = client.onchain.networks.pools.multi.get_addresses(
"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
network="eth",
)
print(response.model_dump_json(indent=2))
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Path Parameters
Network ID.
*refers to /onchain/networks.
Query Parameters
Response
200 - application/json
Multiple pools data
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Price change percentage over various timeframes
Hide child attributes
Hide child attributes
Transaction counts over various timeframes
Hide child attributes
Hide child attributes
Net buy volume in USD over various timeframes
Sell volume in USD over various timeframes
Launchpad details for bonding curve pools
Related resources
Hide child attributes
Hide child attributes
Included related resources, present when include parameter is specified
Hide child attributes
Hide child attributes
Was this page helpful?

