---
title: "Token Info by Token Address"
method: GET
path: "/onchain/networks/{network}/tokens/{address}/info"
---

# Token Info by Token Address

`GET /onchain/networks/{network}/tokens/{address}/info`

## Request

- Base URL: `https://api.coingecko.com/api/v3`
- URL: `https://api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/info`
- Auth: one of:
  - API key in header `x-cg-pro-api-key`
  - API key in query parameter `x_cg_pro_api_key`

To query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network

## Path parameters

- `network` string, required
- `address` string, required

## Response `200`

Token info data

- TokenInfo
  - `data` TokenInfoItem, required
    - `id` string, required: Token identifier
    - `type` string, required: Resource type
    - `attributes` object, required
      - `address` string, required: Token contract address
      - `name` string, required: Token name
      - `symbol` string, required: Token symbol
      - `decimals` integer, required: Token decimals
      - `image_url` string, nullable, required: Token image URL
      - `image` object, required: Token image URLs in different sizes
        - `thumb` string
        - `small` string
        - `large` string
      - `banner_image_url` string, nullable, required: Token banner image URL
      - `coingecko_coin_id` string, nullable, required: CoinGecko coin ID
      - `websites` string[], required: Token websites
      - `discord_url` string, nullable, required: Discord URL
      - `farcaster_url` string, nullable, required: Farcaster URL
      - `zora_url` string, nullable, required: Zora URL
      - `telegram_handle` string, nullable, required: Telegram handle
      - `twitter_handle` string, nullable, required: Twitter handle
      - `description` string, nullable, required: Token description
      - `gt_score` number, required: GeckoTerminal trust score
      - `gt_score_details` object, required: GeckoTerminal trust score breakdown
        - `pool` number
        - `transaction` number
        - `creation` number
        - `info` number
        - `holders` number
      - `gt_verified` boolean, required: Whether the token is verified on GeckoTerminal
      - `categories` string[], required: Token categories
      - `gt_category_ids` string[], required: GeckoTerminal category IDs
      - `holders` object, required: Token holder information
        - `count` integer: Number of holders
        - `distribution_percentage` object: Holder distribution percentage (keys vary by chain, e.g. top_10, 11_30, 31_50, rest)
        - `last_updated` string: Last updated timestamp
      - `mint_authority` string, nullable, required: Mint authority status
      - `freeze_authority` string, nullable, required: Freeze authority status
      - `is_honeypot` union, required: Whether the token is a honeypot (boolean or 'unknown')
        - boolean
        - string
      - `developer_address` string, nullable, required: Developer wallet address
      - `developer_holding_percentage` string, nullable, required: Developer holding as a percentage of total supply

---

[API](https://skmtc.dev/coingecko/apis/coingecko-demo-api.md) - [All operations](https://skmtc.dev/coingecko/apis/coingecko-demo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coingecko/apis/coingecko-demo-api/revisions/d62c9c579f3a?raw)