Skip to main content
GET
/
networks
/
{network}
/
tokens
/
{address}
/
info
Token Info by Token Address
curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/info \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "data": {
    "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
    "type": "token",
    "attributes": {
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "name": "Tether USD",
      "symbol": "USDT",
      "image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
      "image": {
        "thumb": "https://assets.coingecko.com/coins/images/325/thumb/Tether.png?1696501661",
        "small": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
        "large": "https://assets.coingecko.com/coins/images/325/large/Tether.png?1696501661"
      },
      "coingecko_coin_id": "tether",
      "websites": [
        "https://tether.to/"
      ],
      "description": "Tether (USDT) is a cryptocurrency with a value meant to mirror the value of the U.S. dollar...",
      "gt_score": 92.6605504587156,
      "gt_score_details": {
        "pool": 87.5,
        "transaction": 0,
        "creation": 100,
        "info": 100,
        "holders": 0
      },
      "discord_url": null,
      "farcaster_url": null,
      "zora_url": null,
      "telegram_handle": null,
      "twitter_handle": "Tether_to",
      "categories": [],
      "gt_categories_id": [],
      "holders": {
        "count": 7041203,
        "distribution_percentage": {
          "top_10": "45.5782",
          "11_30": "13.4293",
          "31_50": "3.9681",
          "rest": "37.0244"
        },
        "last_updated": "2025-03-12T05:28:50Z"
      },
      "mint_authority": null,
      "freeze_authority": null,
      "is_honeypot": false
    }
  }
}

​
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:

​
Note

  • 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
  • For tokens on a bonding curve (i.e. non-graduated tokens from launchpads), the response will include a launchpad_details object containing their graduation status and details.

Authorizations

​
x-cg-demo-api-key
string
header
required

Path Parameters

​
network
string
default:eth
required

network ID *refers to /networks

Example:

"eth"

​
address
string
default:0xdac17f958d2ee523a2206206994597c13d831ec7
required

token contract address

Example:

"0xdac17f958d2ee523a2206206994597c13d831ec7"

Response

200 - application/json

Get specific token info on a network

​
data
object