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_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
"type": "token",
"attributes": {
"address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
"name": "Pippin",
"symbol": "pippin",
"decimals": 6,
"image_url": "https://coin-images.coingecko.com/coins/images/51589/large/pippin_logo.png?1731570163",
"image": {
"thumb": "https://coin-images.coingecko.com/coins/images/51589/thumb/pippin_logo.png?1731570163",
"small": "https://coin-images.coingecko.com/coins/images/51589/small/pippin_logo.png?1731570163",
"large": "https://coin-images.coingecko.com/coins/images/51589/large/pippin_logo.png?1731570163"
},
"banner_image_url": "https://assets.geckoterminal.com/kn680ou6904r03syp0ecu52ihy9c",
"coingecko_coin_id": "pippin",
"websites": [
"https://pippin.love",
"https://www.yohei.me"
],
"discord_url": null,
"farcaster_url": null,
"zora_url": null,
"telegram_handle": "ThePippinCo",
"twitter_handle": "pippinlovesyou",
"description": "Pippin is an SVG unicorn drawn using the latest LLM benchmarks on ChatGPT 4o. It is an autonomous AI agent on X.",
"gt_score": 86.54440366972477,
"gt_score_details": {
"pool": 87.5,
"transaction": 66.667,
"creation": 100,
"info": 100,
"holders": 100
},
"gt_verified": true,
"categories": [
"Pump Fun",
"Ai Agents"
],
"gt_category_ids": [
"pump-fun",
"ai-agents"
],
"holders": {
"count": 47911,
"distribution_percentage": {
"top_10": "73.7977",
"11_20": "8.7309",
"21_40": "5.6147",
"rest": "11.8567"
},
"last_updated": "2026-05-27T17:41:13Z"
},
"mint_authority": "no",
"freeze_authority": "no",
"is_honeypot": "unknown",
"developer_address": "4t7dHZcUzNC96d79won5TRZsvwP1bumhPNf3awR5BHdu",
"developer_holding_percentage": "0.0"
}
}
}Tokens
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_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
"type": "token",
"attributes": {
"address": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
"name": "Pippin",
"symbol": "pippin",
"decimals": 6,
"image_url": "https://coin-images.coingecko.com/coins/images/51589/large/pippin_logo.png?1731570163",
"image": {
"thumb": "https://coin-images.coingecko.com/coins/images/51589/thumb/pippin_logo.png?1731570163",
"small": "https://coin-images.coingecko.com/coins/images/51589/small/pippin_logo.png?1731570163",
"large": "https://coin-images.coingecko.com/coins/images/51589/large/pippin_logo.png?1731570163"
},
"banner_image_url": "https://assets.geckoterminal.com/kn680ou6904r03syp0ecu52ihy9c",
"coingecko_coin_id": "pippin",
"websites": [
"https://pippin.love",
"https://www.yohei.me"
],
"discord_url": null,
"farcaster_url": null,
"zora_url": null,
"telegram_handle": "ThePippinCo",
"twitter_handle": "pippinlovesyou",
"description": "Pippin is an SVG unicorn drawn using the latest LLM benchmarks on ChatGPT 4o. It is an autonomous AI agent on X.",
"gt_score": 86.54440366972477,
"gt_score_details": {
"pool": 87.5,
"transaction": 66.667,
"creation": 100,
"info": 100,
"holders": 100
},
"gt_verified": true,
"categories": [
"Pump Fun",
"Ai Agents"
],
"gt_category_ids": [
"pump-fun",
"ai-agents"
],
"holders": {
"count": 47911,
"distribution_percentage": {
"top_10": "73.7977",
"11_20": "8.7309",
"21_40": "5.6147",
"rest": "11.8567"
},
"last_updated": "2026-05-27T17:41:13Z"
},
"mint_authority": "no",
"freeze_authority": "no",
"is_honeypot": "unknown",
"developer_address": "4t7dHZcUzNC96d79won5TRZsvwP1bumhPNf3awR5BHdu",
"developer_holding_percentage": "0.0"
}
}
}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 bscOptimism optimismArbitrum arbitrumPolygon polygon_posTON tonSui sui-networkRobinhood robinhoodRonin 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.
Metadata (image, websites, description, socials) may be sourced on-chain and is not vetted by the CoinGecko team.
For CoinGecko-reviewed metadata, use Coin Data by ID or Coin Data by Token Address.
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
const response = await client.onchain.networks.tokens.info.get('Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump', {
network: 'solana',
});
console.log(JSON.stringify(response, null, 2));
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Response
200 - application/json
Token info data
Show child attributes
Show child attributes
Was this page helpful?
⌘I

