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

# Token Data by Token Address

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

To query specific token data based on the provided token contract address on a network

## Path parameters

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

## Query parameters

- `include` 'top_pools'
- `include_composition` boolean
- `include_inactive_source` boolean

## Response `200`

Token data

- TokenData
  - `data` TokenItem, 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
      - `coingecko_coin_id` string, nullable, required — CoinGecko coin ID
      - `total_supply` string, required — Token total supply
      - `normalized_total_supply` string, required — Normalized token total supply
      - `price_usd` string, nullable, required — Token price in USD
      - `fdv_usd` string, nullable, required — Fully diluted valuation in USD
      - `total_reserve_in_usd` string, required — Total reserve in USD across all pools
      - `volume_usd` object, required — Volume in USD
        - `h24` string
      - `market_cap_usd` string, nullable, required — Market cap in USD
      - `last_trade_timestamp` string — Last trade timestamp in UNIX
      - `launchpad_details` object — Launchpad details for pump-style tokens
        - `graduation_percentage` number
        - `completed` boolean
        - `completed_at` string, nullable
        - `migrated_destination_pool_address` string, nullable
    - `relationships` object, required
      - `top_pools` object
        - `data` object[]
          - `id` string
          - `type` string
  - `included` object[] — Included top pool data, present when include=top_pools is specified
    - `id` string
    - `type` string
    - `attributes` object
      - `base_token_price_usd` string
      - `base_token_price_native_currency` string
      - `quote_token_price_usd` string
      - `quote_token_price_native_currency` string
      - `base_token_price_quote_token` string
      - `quote_token_price_base_token` string
      - `address` string
      - `name` string
      - `pool_created_at` string
      - `token_price_usd` string
      - `fdv_usd` string, nullable
      - `market_cap_usd` string, nullable
      - `price_change_percentage` object
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `transactions` object
        - `m5` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `m15` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `m30` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h1` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h6` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h24` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
      - `volume_usd` object
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `reserve_in_usd` string
      - `last_trade_timestamp` string
    - `relationships` object
      - `base_token` object
        - `data` object
          - `id` string
          - `type` string
      - `quote_token` object
        - `data` object
          - `id` string
          - `type` string
      - `dex` object
        - `data` object
          - `id` string
          - `type` string

## Changes

- **2026-05-28** `11cc9e00fd86` — 9 breaking, 4 warning, 21 info
  - for the `query` request parameter `include_inactive_source`, default value `false` was removed
  - the response property `data/attributes/coingecko_coin_id` became nullable for the status `200`
  - the response property `data/attributes/fdv_usd` became nullable for the status `200`
  - the response property `data/attributes/image_url` became nullable for the status `200`
  - …30 more
- **2025-12-18** `a23494dedfc2` — 2 info
  - added the new optional `query` request parameter `include_inactive_source`
  - added the optional property `data/attributes/last_trade_timestamp` to the response with the `200` status
- **2025-09-22** `91c83447321b` — 6 info
  - added the new optional `query` request parameter `include_composition`
  - added the optional property `included/items/attributes/base_token_balance` to the response with the `200` status
  - added the optional property `included/items/attributes/base_token_liquidity_usd` to the response with the `200` status
  - added the optional property `included/items/attributes/quote_token_balance` to the response with the `200` status
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/onchain/networks/:network/tokens/:address/get.md)

---

[API](https://skmtc.dev/coingecko/apis/coingecko-api.md) · [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coingecko/coingecko-api/revisions/006c13c1a566/schema)