Token Info by Token Address

get https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/info

This endpoint allows you to query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network

👍
Tips

If you would like to query token data such as decimals, total supply, price and etc. You can go to this endpoint /networks/{network}/tokens/{address} instead.

Cache/Update frequency: every 60 seconds.

Learn more about GT score here.

Metadata (image, websites, description, socials) may be sourced on-chain and is not vetted by the CoinGecko team. If you wish to get metadata reviewed by CoinGecko team, you may use the following endpoints:

Coin Data by ID

Coin Data by Token Address

📘
Notes

holders data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.

Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin.

distribution_percentage coverage:

Solana: top_10, 11_20, 21_40, rest

Other chains: top_10, 11_30, 31_50, rest

Response

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://pro-api.coingecko.com/api/v3/onchain/networks/network/tokens/address/info \
3
     --header 'accept: application/json'


xxxxxxxxxx
33
}
1
{
2
  "data": {
3
    "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
4
    "type": "token",
5
    "attributes": {
6
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
7
      "name": "Tether USD",
8
      "symbol": "USDT",
9
      "image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
10
      "coingecko_coin_id": "tether",
11
      "websites": [
12
        "https://tether.to/"
13
      ],
14
      "description": "Tether (USDT) is a cryptocurrency with a value meant to mirror the value of the U.S. dollar...",
15
      "gt_score": 92.6605504587156,
16
      "discord_url": null,
17
      "telegram_handle": null,
18
      "twitter_handle": "Tether_to",
19
      "categories": [],
20
      "gt_categories_id": [],
21
      "holders": {
22
        "count": 7041203,
23
        "distribution_percentage": {
24
          "top_10": 45.5782,
25
          "11_30": 13.4293,
26
          "31_50": 3.9681,
27
          "rest": 37.0244
28
        },
29
        "last_updated": "2025-03-12T05:28:50Z"