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_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"
      }
    }
  }
}

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_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.

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`
Polygon	`polygon_pos`
Arbitrum	`arbitrum`
Optimism	`optimism`
Avalanche	`avax`
Stable	`stable`
Robinhood	`robinhood`
Linea	`linea`
Arc	`arc`
TON	`ton`
Sui	`sui-network`
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.
is_nsfw flags 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 the client 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

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.is_nsfw

boolean

required

Whether the token's name or symbol matches the GeckoTerminal NSFW keyword list

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

data.attributes.launchpad_details

object

Launchpad details for pump-style tokens

Hide child attributes

data.attributes.launchpad_details.graduation_percentage

number

data.attributes.launchpad_details.completed

boolean

data.attributes.launchpad_details.completed_at

string | null

data.attributes.launchpad_details.migrated_destination_pool_address

string | null

CoinGecko API

Onchain API

Token Info by Token Address

Notes

SDK Examples

Authorizations

Path Parameters

Response