Tokens

Token Data by Token Address

This endpoint allows you to query specific token data based on the provided token contract address on a network

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

Request

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

Path parameters

networkstring required
Example:eth

network ID<br>*refers to /networks

addressstring required
Example:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

token contract address

Query parameters

attributes to include, comma-separated if more than one to include<br><br><b>Available values:</b> top_pools

include_compositionboolean

include pool composition

include_inactive_sourceboolean

include inactive pools when sourcing for token's top pool

Response

Get specific token on a network

Example response

{
  "data": {
    "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
    "type": "token",
    "attributes": {
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "name": "Tether USD",
      "symbol": "USDT",
      "decimals": 6,
      "image_url": "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661",
      "banner_image_url": null,
      "coingecko_coin_id": "tether",
      "total_supply": "91775654692250534.0",
      "normalized_total_supply": "91775654692.2505",
      "price_usd": "0.999188255",
      "fdv_usd": "91700939859.6687",
      "total_reserve_in_usd": "405089394.14192413773442554227",
      "volume_usd": {
        "h24": "1142454033.37436"
      },
      "market_cap_usd": "171798403974.784"
    },
    "relationships": {
      "top_pools": {
        "data": [
          {
            "id": "eth_0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",
            "type": "pool"
          },
          {
            "id": "eth_0xf063bd202e45d6b2843102cb4ece339026645d4a",
            "type": "pool"
          },
          {
            "id": "eth_0x8aa4e11cbdf30eedc92100f4c8a31ff748e201d44712cc8c90d189edaa8e4e47",
            "type": "pool"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "eth_0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "0.999949947925521",
        "base_token_price_native_currency": "0.000223341206041575",
        "base_token_balance": "74198606.301554",
        "base_token_liquidity_usd": "74194892.50738515",
        "quote_token_price_usd": "0.99918825500163",
        "quote_token_price_native_currency": "0.000223171080110164",
        "quote_token_balance": "29771050.29628",
        "quote_token_liquidity_usd": "29746883.795105774",
        "base_token_price_quote_token": "1.0007623117",
        "quote_token_price_base_token": "0.9992382689",
        "address": "0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",
        "name": "USDC / USDT",
        "pool_created_at": "2025-09-18T08:28:30Z",
        "token_price_usd": "0.99918825500163",
        "fdv_usd": "91700939859.6687",
        "market_cap_usd": "171798403975.064",
        "price_change_percentage": {
          "m5": "-0.02",
          "m15": "-0.65",
          "m30": "-0.01",
          "h1": "0",
          "h6": "-0.18",
          "h24": "-0.5"
        },
        "transactions": {
          "m5": {
            "buys": 0,
            "sells": 2,
            "buyers": 0,
            "sellers": 2
          },
          "m15": {
            "buys": 4,
            "sells": 7,
            "buyers": 3,
            "sellers": 5
          },
          "m30": {
            "buys": 12,
            "sells": 19,
            "buyers": 7,
            "sellers": 9
          },
          "h1": {
            "buys": 39,
            "sells": 48,
            "buyers": 16,
            "sellers": 15
          },
          "h6": {
            "buys": 180,
            "sells": 271,
            "buyers": 31,
            "sellers": 35
          },
          "h24": {
            "buys": 870,
            "sells": 1109,
            "buyers": 55,
            "sellers": 59
          }
        },
        "volume_usd": {
          "m5": "988.7572917698",
          "m15": "1857835.95996426",
          "m30": "3190909.49729904",
          "h1": "9434171.29930675",
          "h6": "84784863.3965608",
          "h24": "388004708.962186"
        },
        "reserve_in_usd": "103939687.035"
      },
      "relationships": {
        "base_token": {
          "data": {
            "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
            "type": "token"
          }
        },
        "dex": {
          "data": {
            "id": "fluid-ethereum",
            "type": "dex"
          }
        }
      }
    }
  ]
}

Changes

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