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

Hide child attributes

data.id

string

required

Token identifier

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.address

string

required

Token contract address

data.attributes.name

string

required

Token name

data.attributes.symbol

string

required

Token symbol

data.attributes.decimals

integer

required

Token decimals

data.attributes.image_url

string | null

required

Token image URL

data.attributes.image

object

required

Token image URLs in different sizes

Hide child attributes

data.attributes.image.thumb

string

data.attributes.image.small

string

data.attributes.image.large

string

data.attributes.banner_image_url

string | null

required

Token banner image URL

data.attributes.coingecko_coin_id

string | null

required

CoinGecko coin ID

data.attributes.websites

string[]

required

Token websites

data.attributes.discord_url

string | null

required

Discord URL

data.attributes.farcaster_url

string | null

required

Farcaster URL

data.attributes.zora_url

string | null

required

Zora URL

data.attributes.telegram_handle

string | null

required

Telegram handle

data.attributes.twitter_handle

string | null

required

Twitter handle

data.attributes.description

string | null

required

Token description

data.attributes.gt_score

number

required

GeckoTerminal trust score

data.attributes.gt_score_details

object

required

GeckoTerminal trust score breakdown

Hide child attributes

data.attributes.gt_score_details.pool

number

data.attributes.gt_score_details.transaction

number

data.attributes.gt_score_details.creation

number

data.attributes.gt_score_details.info

number

data.attributes.gt_score_details.holders

number

data.attributes.gt_verified

boolean

required

Whether the token is verified on GeckoTerminal

data.attributes.categories

string[]

required

Token categories

data.attributes.gt_category_ids

string[]

required

GeckoTerminal category IDs

data.attributes.holders

object

required

Token holder information

Hide child attributes

data.attributes.holders.count

integer

Number of holders

data.attributes.holders.distribution_percentage

object

Holder distribution percentage (keys vary by chain, e.g. top_10, 11_30, 31_50, rest)

Hide child attributes

data.attributes.holders.distribution_percentage.{key}

string

data.attributes.holders.last_updated

string

Last updated timestamp

data.attributes.mint_authority

string | null

required

Mint authority status

data.attributes.freeze_authority

string | null

required

Freeze authority status

data.attributes.is_honeypot

required

Whether the token is a honeypot (boolean or 'unknown')

data.attributes.developer_address

string | null

required

Developer wallet address

data.attributes.developer_holding_percentage

string | null

required

Developer holding as a percentage of total supply

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