> ## 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.
# Tokens Data by Token Addresses across Networks
> To query multiple tokens data based on the provided token contract addresses across multiple networks in a single request
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;
};
export const PlanExclusivity = ({tier}) => {
if (tier === "enterprise") {
return
Enterprise Only
This endpoint is exclusively available to Enterprise plan.
→ Contact sales
;
}
if (tier === "analyst_above") {
return
Analyst Plan and Above
This endpoint is only available to Analyst, Lite, Pro, and Enterprise plan.
→ View pricing
;
}
if (tier === "basic_above") {
return
Basic Plan and Above
This endpoint is only available to Basic, Analyst, Lite, Pro, and Enterprise plan.
→ View pricing
;
}
throw new Error(`PlanExclusivity: invalid tier "${tier}". Use "basic_above", "analyst_above", or "enterprise".`);
};
#### Notes
* Each `tokens` entry pairs a network ID with a token contract address, separated by `:`
* For example, `eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2,polygon_pos:0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270`.
* Networks can be mixed freely in one request, up to **50 pairs**.
* Each token carries an `attributes.network` field, so a token address that appears on several networks stays unambiguous.
* Returns the top most liquid pool per token, ranked by liquidity (`reserve_in_usd`) and 24-hour volume (`volume_usd`).
* `total_reserve_in_usd` represents the total reserve of the requested token only across all its pools, not both tokens in a pair.
* 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=top_pools` to include top pools data. Add `include_composition=true` to surface balance and liquidity of base and quote tokens (requires `include=top_pools`).
* Bonding curve tokens (non-graduated launchpad tokens) include a `launchpad_details` object with graduation status.
An unknown network ID fails the whole request, while an unknown token address does not.
* An unsupported `network_id` returns a `400` naming the offending IDs.
* A token address that cannot be resolved on a supported network is omitted from the response.
For token metadata (socials, websites, description), use [Token Info](/reference/token-info-contract-address) instead.
## OpenAPI
````yaml openapi-specs/pro-api.json get /onchain/tokens/multi
openapi: 3.0.0
info:
title: CoinGecko Pro API
version: 3.0.0
servers:
- url: https://pro-api.coingecko.com/api/v3
security:
- headerAuth: []
- queryAuth: []
paths:
/onchain/tokens/multi:
get:
summary: Tokens Data by Token Addresses across Networks
description: >-
To query multiple tokens data based on the provided token contract
addresses across multiple networks in a single request
operationId: tokens-data-contract-addresses-multi
parameters:
- name: tokens
in: query
required: true
description: >-
Network ID and token contract address pairs in
`network_id:token_address` format, comma-separated if more than
one.
Maximum: 50
*refers to [`/onchain/networks`](/reference/networks-list).
schema:
type: string
default: >-
solana:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN,solana:2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump
- name: include
in: query
required: false
description: Attributes to include.
schema:
type: string
enum:
- top_pools
- name: include_composition
in: query
required: false
description: |-
Include pool composition.
Default: `false`
schema:
type: boolean
- name: include_inactive_source
in: query
required: false
description: |-
Include tokens from inactive pools using the most recent swap.
Default: `false`
schema:
type: boolean
responses:
'200':
description: Multiple tokens data across networks
content:
application/json:
schema:
$ref: '#/components/schemas/MultiNetworkTokenData'
example:
data:
- id: solana_2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump
type: token
attributes:
network: solana
address: 2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump
name: SORACAT
symbol: SORACAT
decimals: 6
image_url: >-
https://assets.geckoterminal.com/o6djbxjg7ne8k1swjpybmdvtu11s
coingecko_coin_id: null
total_supply: '1000000000000000.0'
normalized_total_supply: '1000000000.0'
price_usd: '0.000006746080385'
fdv_usd: '6746.080385'
total_reserve_in_usd: '5234.61248798976042147487629165'
volume_usd:
h24: '0.0'
market_cap_usd: null
launchpad_details:
graduation_percentage: 2.16
completed: false
completed_at: null
migrated_destination_pool_address: null
last_trade_timestamp: '1759502562'
relationships:
top_pools:
data:
- id: >-
solana_7Dyotb31T3wmXzCkVvTERDDz2jvfTCCPmqQJxHHhCXyf
type: pool
- id: solana_6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
type: token
attributes:
network: solana
address: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
name: OFFICIAL TRUMP
symbol: TRUMP
decimals: 6
image_url: >-
https://coin-images.coingecko.com/coins/images/53746/large/trump.png?1737171561
coingecko_coin_id: official-trump
total_supply: '999998998459989.0'
normalized_total_supply: '999998998.459989'
price_usd: '1.9985180848'
fdv_usd: '1998516083.23562'
total_reserve_in_usd: >-
14255371.854780720267033781372948483553082010921812333809387849645046911446193223125739904
volume_usd:
h24: '12492580.7016379'
market_cap_usd: '546537047.922803'
last_trade_timestamp: '1789029026'
relationships:
top_pools:
data:
- id: >-
solana_3C5YE97HADPDxZehYq9Cis8AXr9aNyrUsczKzE1nDbW9
type: pool
included:
- id: solana_7Dyotb31T3wmXzCkVvTERDDz2jvfTCCPmqQJxHHhCXyf
type: pool
attributes:
base_token_price_usd: '0.000006746080385'
base_token_price_native_currency: '0.0000000294042292075217'
base_token_balance: '775948727.097393'
base_token_liquidity_usd: >-
5248.9884755507223940299343365554517590694012261684516223803972
quote_token_price_usd: '229.4255135152'
quote_token_price_native_currency: '1.0'
quote_token_balance: '0.487321883'
quote_token_liquidity_usd: '112.1111244392582328850588200028936997988529170348984'
base_token_price_quote_token: '0.00000002940422921'
quote_token_price_base_token: '34008713.2685048'
address: 7Dyotb31T3wmXzCkVvTERDDz2jvfTCCPmqQJxHHhCXyf
name: SORACAT / SOL
pool_created_at: '2025-10-03T14:42:39Z'
fdv_usd: '6746.080385'
market_cap_usd: null
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'
reserve_in_usd: '5361.0996'
last_trade_timestamp: '1759502562'
relationships:
base_token:
data:
id: solana_2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump
type: token
quote_token:
data:
id: solana_So11111111111111111111111111111111111111112
type: token
dex:
data:
id: pump-fun
type: dex
- id: solana_3C5YE97HADPDxZehYq9Cis8AXr9aNyrUsczKzE1nDbW9
type: pool
attributes:
base_token_price_usd: >-
1.99851808483144460459345181213426376306892473592748947769977548
base_token_price_native_currency: '0.0197707311569055'
base_token_balance: '3369368.677711'
base_token_liquidity_usd: >-
6728086.2507852995170294801492731248304882348663868551291
quote_token_price_usd: >-
0.999902404983271294826273480360971101736563367728011809421745788
quote_token_price_native_currency: '0.0098961031586542'
quote_token_balance: '5754828.165871'
quote_token_liquidity_usd: >-
5751973.2773146513272334336111493373372596038279418070678
base_token_price_quote_token: '1.9978299377'
quote_token_price_base_token: '0.5005431049'
address: 3C5YE97HADPDxZehYq9Cis8AXr9aNyrUsczKzE1nDbW9
name: TRUMP / USDC
pool_created_at: '2025-01-18T06:53:58Z'
fdv_usd: '1999192306.72691'
market_cap_usd: '546054176.455686'
price_change_percentage:
m5: '-0.381'
m15: '0.019'
m30: '0.336'
h1: '0.714'
h6: '-0.777'
h24: '-11.896'
transactions:
m5:
buys: 1
sells: 27
buyers: 1
sellers: 12
m15:
buys: 19
sells: 42
buyers: 12
sellers: 22
m30:
buys: 32
sells: 54
buyers: 15
sellers: 27
h1:
buys: 90
sells: 74
buyers: 20
sellers: 33
h6:
buys: 511
sells: 453
buyers: 82
sellers: 123
h24:
buys: 6012
sells: 6490
buyers: 1834
sellers: 1989
volume_usd:
m5: '16395.5852203664'
m15: '57102.4676731082'
m30: '91363.2436414857'
h1: '159725.534904872'
h6: '1031003.7246258'
h24: '8097898.68584492'
reserve_in_usd: '12480059.5281'
last_trade_timestamp: '1789029187'
relationships:
base_token:
data:
id: solana_6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
type: token
quote_token:
data:
id: solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
type: token
dex:
data:
id: uniswap_v3
type: dex
components:
schemas:
MultiNetworkTokenData:
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/MultiNetworkTokenItem'
included:
type: array
description: Included top pool data, present when include=top_pools is specified
items:
type: object
properties:
id:
type: string
type:
type: string
attributes:
type: object
properties:
base_token_price_usd:
type: string
base_token_price_native_currency:
type: string
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
quote_token_price_native_currency:
type: string
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
quote_token_price_base_token:
type: string
address:
type: string
name:
type: string
pool_created_at:
type: string
fdv_usd:
type: string
nullable: true
market_cap_usd:
type: string
nullable: true
price_change_percentage:
type: object
properties:
m5:
type: string
m15:
type: string
m30:
type: string
h1:
type: string
h6:
type: string
h24:
type: string
transactions:
type: object
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
properties:
m5:
type: string
m15:
type: string
m30:
type: string
h1:
type: string
h6:
type: string
h24:
type: string
reserve_in_usd:
type: string
last_trade_timestamp:
type: string
description: Last trade timestamp in UNIX
relationships:
type: object
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
MultiNetworkTokenItem:
type: object
required:
- id
- type
- attributes
- relationships
properties:
id:
type: string
description: Token identifier
type:
type: string
description: Resource type
attributes:
type: object
required:
- network
- address
- name
- symbol
- decimals
- image_url
- coingecko_coin_id
- total_supply
- normalized_total_supply
- price_usd
- fdv_usd
- total_reserve_in_usd
- volume_usd
- market_cap_usd
properties:
network:
type: string
description: Network ID of the token
address:
type: string
description: Token contract address
name:
type: string
description: Token name
symbol:
type: string
description: Token symbol
decimals:
type: integer
description: Token decimals
image_url:
type: string
nullable: true
description: Token image URL
coingecko_coin_id:
type: string
nullable: true
description: CoinGecko coin ID
total_supply:
type: string
description: Token total supply
normalized_total_supply:
type: string
description: Normalized token total supply
price_usd:
type: string
nullable: true
description: Token price in USD
fdv_usd:
type: string
nullable: true
description: Fully diluted valuation in USD
total_reserve_in_usd:
type: string
description: Total reserve in USD across all pools
volume_usd:
type: object
description: Volume in USD
properties:
h24:
type: string
market_cap_usd:
type: string
nullable: true
description: Market cap in USD
last_trade_timestamp:
type: string
description: Last trade timestamp in UNIX
launchpad_details:
type: object
description: Launchpad details for pump-style tokens
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
properties:
top_pools:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: string
type:
type: string
securitySchemes:
headerAuth:
type: apiKey
in: header
name: x-cg-pro-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_pro_api_key
description: >-
Learn how to [set up your API
key](https://docs.coingecko.com/docs/setting-up-your-api-key)
````