Token Info by Token Address
curl --request GET \
--url https://api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/info \
--header 'x-cg-demo-api-key: <api-key>'{
"data": {
"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",
"image": {
"thumb": "https://coin-images.coingecko.com/coins/images/70552/thumb/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550",
"small": "https://coin-images.coingecko.com/coins/images/70552/small/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550",
"large": "https://coin-images.coingecko.com/coins/images/70552/large/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550"
},
"banner_image_url": "https://assets.geckoterminal.com/jqqvglmmbsvkrafnplr30mcp6783",
"coingecko_coin_id": "wojak-4",
"websites": [
"https://wojakmeme.fun"
],
"discord_url": null,
"farcaster_url": null,
"zora_url": null,
"telegram_handle": null,
"twitter_handle": "wojakonx",
"description": "Wojak aka Feels Guy - the biggest meme in crypto",
"gt_score": 72.74778837438193,
"gt_score_details": {
"pool": 77.143,
"transaction": 64,
"creation": 100,
"info": 100,
"holders": 81.25
},
"gt_verified": true,
"categories": [
"Pump Fun",
"Wojak"
],
"gt_category_ids": [
"pump-fun",
"wojak"
],
"holders": {
"count": 19901,
"distribution_percentage": {
"top_10": "32.9547",
"11_20": "7.1417",
"21_40": "9.5026",
"rest": "50.401"
},
"last_updated": "2026-09-29T03:08:40Z"
},
"mint_authority": "no",
"freeze_authority": "no",
"is_honeypot": "unknown",
"is_nsfw": false,
"developer_address": "J3k4T9XHhhAGrZ64ukcya19FApC8jf8xaTWwYJfjTR4p",
"developer_holding_percentage": "10.72",
"launchpad_details": {
"graduation_percentage": 100,
"completed": true,
"completed_at": "2025-11-03T20:41:29.000Z",
"migrated_destination_pool_address": "FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7"
}
}
}
}Token Info by Token Address
To query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network
GET
/
onchain
/
networks
/
{network}
/
tokens
/
{address}
/
info
Token Info by Token Address
curl --request GET \
--url https://api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/info \
--header 'x-cg-demo-api-key: <api-key>'{
"data": {
"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",
"image": {
"thumb": "https://coin-images.coingecko.com/coins/images/70552/thumb/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550",
"small": "https://coin-images.coingecko.com/coins/images/70552/small/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550",
"large": "https://coin-images.coingecko.com/coins/images/70552/large/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550"
},
"banner_image_url": "https://assets.geckoterminal.com/jqqvglmmbsvkrafnplr30mcp6783",
"coingecko_coin_id": "wojak-4",
"websites": [
"https://wojakmeme.fun"
],
"discord_url": null,
"farcaster_url": null,
"zora_url": null,
"telegram_handle": null,
"twitter_handle": "wojakonx",
"description": "Wojak aka Feels Guy - the biggest meme in crypto",
"gt_score": 72.74778837438193,
"gt_score_details": {
"pool": 77.143,
"transaction": 64,
"creation": 100,
"info": 100,
"holders": 81.25
},
"gt_verified": true,
"categories": [
"Pump Fun",
"Wojak"
],
"gt_category_ids": [
"pump-fun",
"wojak"
],
"holders": {
"count": 19901,
"distribution_percentage": {
"top_10": "32.9547",
"11_20": "7.1417",
"21_40": "9.5026",
"rest": "50.401"
},
"last_updated": "2026-09-29T03:08:40Z"
},
"mint_authority": "no",
"freeze_authority": "no",
"is_honeypot": "unknown",
"is_nsfw": false,
"developer_address": "J3k4T9XHhhAGrZ64ukcya19FApC8jf8xaTWwYJfjTR4p",
"developer_holding_percentage": "10.72",
"launchpad_details": {
"graduation_percentage": 100,
"completed": true,
"completed_at": "2025-11-03T20:41:29.000Z",
"migrated_destination_pool_address": "FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7"
}
}
}
}Notes
- Learn more about GT Score and GT Verified.
holdersdata is currently in Beta, with ongoing improvements to coverage and update frequency.Supported networks
Chain Network idSolana solanaEthereum ethBase baseBNB Chain bscPolygon polygon_posArbitrum arbitrumOptimism optimismAvalanche avaxStable stableRobinhood robinhoodLinea lineaArc arcMonad monadUnichain unichainZkSync zksyncWorld Chain world-chainHyperEVM hyperevmTON tonSui sui-networkRonin roninBittensor bittensordistribution_percentageis based on total supply and includes all wallet types (CEX, treasury, etc.):- Solana:
top_10,11_20,21_40,rest - Other chains:
top_10,11_30,31_50,rest
- Solana:
- Bonding curve tokens (non-graduated launchpad tokens) include a
launchpad_detailsobject with graduation status. is_nsfwflags tokens with NSFW names or symbols, useful for filtering them out of your app.
- Metadata (image, websites, description, socials) is unvetted unless the token is GT Verified (
gt_verified: true) or reviewed by CoinGecko. - For CoinGecko-reviewed metadata, use Coin Data by ID or Coin Data by Token Address.
For token market data (price, supply, volume), use Token Data instead.
SDK Examples
New to the SDK? Install and authenticate theclient first:TypeScript | Python
const response = await client.onchain.networks.tokens.info.get('Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump', {
network: 'solana',
});
console.log(JSON.stringify(response, null, 2));
response = client.onchain.networks.tokens.info.get(
"Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
network="solana",
)
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.
Response
200 - application/json
Token info data
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Token holder information
Hide child attributes
Hide child attributes
Launchpad details for pump-style tokens
Was this page helpful?

