Tokens Data by Token Addresses across Networks
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/tokens/multi \
--header 'x-cg-pro-api-key: <api-key>'{
"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"
}
}
}
}
]
}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
GET
/
onchain
/
tokens
/
multi
Tokens Data by Token Addresses across Networks
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/tokens/multi \
--header 'x-cg-pro-api-key: <api-key>'{
"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"
}
}
}
}
]
}Notes
- Each
tokensentry 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.networkfield, so a token address that appears on several networks stays unambiguous.
- For example,
- Returns the top most liquid pool per token, ranked by liquidity (
reserve_in_usd) and 24-hour volume (volume_usd). total_reserve_in_usdrepresents 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_poolsto include top pools data. Addinclude_composition=trueto surface balance and liquidity of base and quote tokens (requiresinclude=top_pools). - Bonding curve tokens (non-graduated launchpad tokens) include a
launchpad_detailsobject with graduation status.
An unknown network ID fails the whole request, while an unknown token address does not.
- An unsupported
network_idreturns a400naming 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 instead.
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Query Parameters
tokens
string
default:solana:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN,solana:2g4LS3y2myPe6vj9wTvoBE1wKqxvhnZPoZA9QU9upump
required
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.
Attributes to include.
Available options:
top_pools Include pool composition.
Default: false
Include tokens from inactive pools using the most recent swap.
Default: false
Response
200 - application/json
Multiple tokens data across networks
Hide child attributes
Hide child attributes
Token identifier
Resource type
Hide child attributes
Hide child attributes
Network ID of the token
Token contract address
Token name
Token symbol
Token decimals
Token image URL
CoinGecko coin ID
Token total supply
Normalized token total supply
Token price in USD
Fully diluted valuation in USD
Total reserve in USD across all pools
Market cap in USD
Last trade timestamp in UNIX
Launchpad details for pump-style tokens
Included top pool data, present when include=top_pools is specified
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Base token balance in pool
Base token liquidity in USD
Quote token balance in pool
Quote token liquidity in USD
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Last trade timestamp in UNIX
Hide child attributes
Hide child attributes
Was this page helpful?