Tokens

Token Info by Token Address

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

get/networks/{network}/tokens/{address}/info

Request

Base URL: https://api.geckoterminal.com/api/v2
URL: https://api.geckoterminal.com/api/v2/networks/{network}/tokens/{address}/info
Auth: none declared

Path parameters

networkstring required

Example:eth

network ID<br>*refers to /networks

addressstring required

Example:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

token contract address

Response

Get specific token info on a network. Data may be sourced on-chain and is not vetted by the CoinGecko team.

Example response

{
  "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"
      },
      "banner_image_url": "https://assets.geckoterminal.com/vgvwashzmsg7qt9iamrclayfplde",
      "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,
      "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,
      "developer_address": null,
      "developer_holding_percentage": null
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.