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

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>'

200

{
  "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"
      },
      "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 chains: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, Ronin.
  • 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.

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 token market data (price, supply, volume), use Token Data instead.

SDK Examples

TypeScript

const response = await client.onchain.networks.tokens.info.get('Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump', {
  network: 'solana',
});

console.log(JSON.stringify(response, null, 2));

Authorizations

headerAuthqueryAuth

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