> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Multiple Pools Data by Pool Addresses
> To query multiple pools based on the provided network and pool addresses
export const CacheInfo = ({publicRate, paidRate, rate}) => {
const fmt = v => v === 0 ? 'Real-time (Cacheless)' : `Every ${v}`;
if (rate !== undefined) {
return
Cache / Update Frequency:
{fmt(rate)}
;
}
if (publicRate !== undefined && paidRate !== undefined) {
return
Cache / Update Frequency:- {fmt(paidRate)} (Paid API)
- {fmt(publicRate)} (Demo / Keyless API)
;
}
return null;
};
#### Notes
* Addresses not found in GeckoTerminal will be ignored.
* Supports up to **30 pool addresses** per request. [Analyst plan or above](https://www.coingecko.com/en/api/pricing) 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 `include` to return related attributes under the top-level `included` key.
* `locked_liquidity_percentage` is updated daily.
* Set `include_composition=true` to surface balance and liquidity of base and quote tokens.
* Bonding curve pools (non-graduated launchpad pools) return a `launchpad_details` object with graduation status.
#### SDK Examples
```typescript TypeScript theme={null}
const response = await client.onchain.networks.pools.multi.getAddresses('0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640', {
network: 'eth',
});
console.log(JSON.stringify(response, null, 2));
```
```python Python theme={null}
response = client.onchain.networks.pools.multi.get_addresses(
"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
network="eth",
)
print(response.model_dump_json(indent=2))
```
## OpenAPI
````yaml openapi-specs/demo-api.json get /onchain/networks/{network}/pools/multi/{addresses}
openapi: 3.0.0
info:
title: CoinGecko Demo API
version: 3.0.0
servers:
- url: https://api.coingecko.com/api/v3
security:
- headerAuth: []
- queryAuth: []
paths:
/onchain/networks/{network}/pools/multi/{addresses}:
get:
summary: Multiple Pools Data by Pool Addresses
description: To query multiple pools based on the provided network and pool addresses
operationId: pools-addresses
parameters:
- name: network
in: path
required: true
description: |-
Network ID.
*refers to [`/onchain/networks`](/reference/networks-list).
schema:
type: string
default: eth
- name: addresses
in: path
required: true
description: >-
Pool contract address, comma-separated if more than one pool
contract address.
schema:
type: string
default: '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640'
- name: include
in: query
required: false
description: |-
Attributes to include, comma-separated if more than one.
Available values: `base_token`, `quote_token`, `dex`
schema:
type: string
- name: include_volume_breakdown
in: query
required: false
description: |-
Include volume breakdown.
Default: `false`
schema:
type: boolean
- name: include_composition
in: query
required: false
description: |-
Include pool composition.
Default: `false`
schema:
type: boolean
responses:
'200':
description: Multiple pools data
content:
application/json:
schema:
$ref: '#/components/schemas/MultiPoolAddressData'
example:
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
components:
schemas:
MultiPoolAddressData:
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/PoolAddressItem'
included:
type: array
description: >-
Included related resources, present when include parameter is
specified
items:
type: object
properties:
id:
type: string
type:
type: string
attributes:
type: object
properties:
address:
type: string
name:
type: string
symbol:
type: string
decimals:
type: integer
image_url:
type: string
coingecko_coin_id:
type: string
PoolAddressItem:
type: object
required:
- id
- type
- attributes
- relationships
properties:
id:
type: string
description: Pool identifier
type:
type: string
description: Resource type
attributes:
type: object
required:
- base_token_price_usd
- base_token_price_native_currency
- quote_token_price_usd
- quote_token_price_native_currency
- base_token_price_quote_token
- quote_token_price_base_token
- address
- name
- pool_name
- pool_fee_percentage
- pool_created_at
- fdv_usd
- market_cap_usd
- price_change_percentage
- transactions
- volume_usd
- reserve_in_usd
- locked_liquidity_percentage
properties:
base_token_price_usd:
type: string
description: Base token price in USD
base_token_price_native_currency:
type: string
description: Base token price in native currency
base_token_balance:
type: string
description: Base token balance in pool
base_token_liquidity_usd:
type: string
description: Base token liquidity in USD
quote_token_price_usd:
type: string
description: Quote token price in USD
quote_token_price_native_currency:
type: string
description: Quote token price in native currency
quote_token_balance:
type: string
description: Quote token balance in pool
quote_token_liquidity_usd:
type: string
description: Quote token liquidity in USD
base_token_price_quote_token:
type: string
description: Base token price in quote token
quote_token_price_base_token:
type: string
description: Quote token price in base token
address:
type: string
description: Pool contract address
name:
type: string
description: Pool name with fee tier
pool_name:
type: string
description: Pool name without fee tier
pool_fee_percentage:
type: string
nullable: true
description: Pool fee percentage
pool_created_at:
type: string
description: Pool creation timestamp
fdv_usd:
type: string
nullable: true
description: Fully diluted valuation in USD
market_cap_usd:
type: string
nullable: true
description: Market cap in USD
price_change_percentage:
type: object
description: Price change percentage over various timeframes
properties:
m5:
type: string
m15:
type: string
m30:
type: string
h1:
type: string
h6:
type: string
h24:
type: string
transactions:
type: object
description: Transaction counts over various timeframes
properties:
m5:
type: object
properties:
buys:
type: integer
sells:
type: integer
buyers:
type: integer
sellers:
type: integer
m15:
type: object
properties:
buys:
type: integer
sells:
type: integer
buyers:
type: integer
sellers:
type: integer
m30:
type: object
properties:
buys:
type: integer
sells:
type: integer
buyers:
type: integer
sellers:
type: integer
h1:
type: object
properties:
buys:
type: integer
sells:
type: integer
buyers:
type: integer
sellers:
type: integer
h6:
type: object
properties:
buys:
type: integer
sells:
type: integer
buyers:
type: integer
sellers:
type: integer
h24:
type: object
properties:
buys:
type: integer
sells:
type: integer
buyers:
type: integer
sellers:
type: integer
volume_usd:
type: object
description: Volume in USD over various timeframes
properties:
m5:
type: string
m15:
type: string
m30:
type: string
h1:
type: string
h6:
type: string
h24:
type: string
net_buy_volume_usd:
type: object
description: Net buy volume in USD over various timeframes
properties:
m5:
type: string
m15:
type: string
m30:
type: string
h1:
type: string
h6:
type: string
h24:
type: string
buy_volume_usd:
type: object
description: Buy volume in USD over various timeframes
properties:
m5:
type: string
m15:
type: string
m30:
type: string
h1:
type: string
h6:
type: string
h24:
type: string
sell_volume_usd:
type: object
description: Sell volume in USD over various timeframes
properties:
m5:
type: string
m15:
type: string
m30:
type: string
h1:
type: string
h6:
type: string
h24:
type: string
reserve_in_usd:
type: string
description: Total reserve in USD
locked_liquidity_percentage:
type: string
nullable: true
description: Locked liquidity percentage
launchpad_details:
type: object
description: Launchpad details for bonding curve pools
properties:
graduation_percentage:
type: number
completed:
type: boolean
completed_at:
type: string
nullable: true
migrated_destination_pool_address:
type: string
nullable: true
relationships:
type: object
description: Related resources
properties:
base_token:
type: object
properties:
data:
type: object
properties:
id:
type: string
type:
type: string
quote_token:
type: object
properties:
data:
type: object
properties:
id:
type: string
type:
type: string
dex:
type: object
properties:
data:
type: object
properties:
id:
type: string
type:
type: string
securitySchemes:
headerAuth:
type: apiKey
in: header
name: x-cg-demo-api-key
description: >-
Learn how to [set up your API
key](https://docs.coingecko.com/docs/setting-up-your-api-key)
queryAuth:
type: apiKey
in: query
name: x_cg_demo_api_key
description: >-
Learn how to [set up your API
key](https://docs.coingecko.com/docs/setting-up-your-api-key)
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.