Token Info by Token Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/info \
  --header 'x-cg-pro-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"
    }
  }
}

GET

onchain

networks

{network}

tokens

{address}

info

Token Info by Token Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/info \
  --header 'x-cg-pro-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.
holders data is currently in Beta, with ongoing improvements to coverage and update frequency.
Supported networks
Chain Network id
Solana solana
Ethereum eth
Base base
BNB Chain bsc
Optimism optimism
Arbitrum arbitrum
Polygon polygon_pos
TON ton
Sui sui-network
Robinhood robinhood
Ronin ronin
Bittensor bittensor
- distribution_percentage is 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
Bonding curve tokens (non-graduated launchpad tokens) include a launchpad_details object with graduation status.

Chain	Network `id`
Solana	`solana`
Ethereum	`eth`
Base	`base`
BNB Chain	`bsc`
Optimism	`optimism`
Arbitrum	`arbitrum`
Polygon	`polygon_pos`
TON	`ton`
Sui	`sui-network`
Robinhood	`robinhood`
Ronin	`ronin`
Bittensor	`bittensor`

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

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

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

network

string

default:solana

required

Network ID. *refers to /onchain/networks.

address

string

default:Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump

required

Token contract address.

Response

200 - application/json

Token info data

data

object

required

Show child attributes

⌘I

CoinGecko API

Onchain API

Token Info by Token Address

Notes

SDK Examples

Authorizations

Path Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Response

Notes

SDK Examples