Token Data by Token Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address} \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": {
    "id": "solana_8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
    "type": "token",
    "attributes": {
      "address": "8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
      "name": "Wojak",
      "symbol": "WOJAK",
      "decimals": 6,
      "image_url": "https://coin-images.coingecko.com/coins/images/70552/large/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550",
      "coingecko_coin_id": "wojak-4",
      "total_supply": "999846202569505.0",
      "normalized_total_supply": "999846202.569505",
      "price_usd": "0.002108045566",
      "fdv_usd": "2107721.35423239",
      "total_reserve_in_usd": "324836.697324327524302253045722035111416063520235345591137965837590196823952",
      "volume_usd": {
        "h24": "235212.154504941"
      },
      "market_cap_usd": "2107721.3542324",
      "launchpad_details": {
        "graduation_percentage": 100,
        "completed": true,
        "completed_at": "2025-11-03T20:41:29.000Z",
        "migrated_destination_pool_address": "FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7"
      },
      "last_trade_timestamp": "1790730160"
    },
    "relationships": {
      "top_pools": {
        "data": [
          {
            "id": "solana_FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7",
            "type": "pool"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "solana_FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "0.00210804556622384486732684033609689566750787551092744720636443282",
        "base_token_price_native_currency": "0.0000176991479492709",
        "base_token_balance": "89850308.783025",
        "base_token_liquidity_usd": "189262.4977768931995821450829183274527396144422153271057",
        "quote_token_price_usd": "119.104353060718103222982579358448975276457545138",
        "quote_token_price_native_currency": "1.0",
        "quote_token_balance": "1587.903236302",
        "quote_token_liquidity_usd": "188980.3581231072840151000952817560870073139787",
        "base_token_price_quote_token": "0.00001769914795",
        "quote_token_price_base_token": "56499.8949591353",
        "address": "FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7",
        "name": "WOJAK / SOL",
        "pool_created_at": "2025-11-03T20:41:29Z",
        "token_price_usd": "0.00210804556622384486732684033609689566750787551092744720636443282",
        "fdv_usd": "2107721.35400858",
        "market_cap_usd": "2107721.35400859",
        "price_change_percentage": {
          "m5": "0",
          "m15": "0.21",
          "m30": "0.36",
          "h1": "0.29",
          "h6": "-4.34",
          "h24": "-18.37"
        },
        "transactions": {
          "m5": {
            "buys": 1,
            "sells": 0,
            "buyers": 1,
            "sellers": 0
          },
          "m15": {
            "buys": 2,
            "sells": 0,
            "buyers": 2,
            "sellers": 0
          },
          "m30": {
            "buys": 7,
            "sells": 3,
            "buyers": 4,
            "sellers": 3
          },
          "h1": {
            "buys": 10,
            "sells": 3,
            "buyers": 7,
            "sellers": 3
          },
          "h6": {
            "buys": 90,
            "sells": 103,
            "buyers": 60,
            "sellers": 74
          },
          "h24": {
            "buys": 718,
            "sells": 756,
            "buyers": 449,
            "sellers": 478
          }
        },
        "volume_usd": {
          "m5": "95.7039366558",
          "m15": "101.6537126364",
          "m30": "412.9239965688",
          "h1": "418.5146583339",
          "h6": "21670.2337988852",
          "h24": "196594.914390978"
        },
        "reserve_in_usd": "378242.8559",
        "last_trade_timestamp": "1790730702"
      },
      "relationships": {
        "base_token": {
          "data": {
            "id": "solana_8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "solana_So11111111111111111111111111111111111111112",
            "type": "token"
          }
        },
        "dex": {
          "data": {
            "id": "pumpswap",
            "type": "dex"
          }
        }
      }
    }
  ]
}

GET

onchain

networks

{network}

tokens

{address}

Token Data by Token Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address} \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": {
    "id": "solana_8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
    "type": "token",
    "attributes": {
      "address": "8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
      "name": "Wojak",
      "symbol": "WOJAK",
      "decimals": 6,
      "image_url": "https://coin-images.coingecko.com/coins/images/70552/large/o6zl61yh9k32fu3rimuoe4sxlfeq.?1762469550",
      "coingecko_coin_id": "wojak-4",
      "total_supply": "999846202569505.0",
      "normalized_total_supply": "999846202.569505",
      "price_usd": "0.002108045566",
      "fdv_usd": "2107721.35423239",
      "total_reserve_in_usd": "324836.697324327524302253045722035111416063520235345591137965837590196823952",
      "volume_usd": {
        "h24": "235212.154504941"
      },
      "market_cap_usd": "2107721.3542324",
      "launchpad_details": {
        "graduation_percentage": 100,
        "completed": true,
        "completed_at": "2025-11-03T20:41:29.000Z",
        "migrated_destination_pool_address": "FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7"
      },
      "last_trade_timestamp": "1790730160"
    },
    "relationships": {
      "top_pools": {
        "data": [
          {
            "id": "solana_FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7",
            "type": "pool"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "solana_FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "0.00210804556622384486732684033609689566750787551092744720636443282",
        "base_token_price_native_currency": "0.0000176991479492709",
        "base_token_balance": "89850308.783025",
        "base_token_liquidity_usd": "189262.4977768931995821450829183274527396144422153271057",
        "quote_token_price_usd": "119.104353060718103222982579358448975276457545138",
        "quote_token_price_native_currency": "1.0",
        "quote_token_balance": "1587.903236302",
        "quote_token_liquidity_usd": "188980.3581231072840151000952817560870073139787",
        "base_token_price_quote_token": "0.00001769914795",
        "quote_token_price_base_token": "56499.8949591353",
        "address": "FDrY5i5kuadZ1ik8gPS26qjj9Rw9mpufXMegGC2HNSP7",
        "name": "WOJAK / SOL",
        "pool_created_at": "2025-11-03T20:41:29Z",
        "token_price_usd": "0.00210804556622384486732684033609689566750787551092744720636443282",
        "fdv_usd": "2107721.35400858",
        "market_cap_usd": "2107721.35400859",
        "price_change_percentage": {
          "m5": "0",
          "m15": "0.21",
          "m30": "0.36",
          "h1": "0.29",
          "h6": "-4.34",
          "h24": "-18.37"
        },
        "transactions": {
          "m5": {
            "buys": 1,
            "sells": 0,
            "buyers": 1,
            "sellers": 0
          },
          "m15": {
            "buys": 2,
            "sells": 0,
            "buyers": 2,
            "sellers": 0
          },
          "m30": {
            "buys": 7,
            "sells": 3,
            "buyers": 4,
            "sellers": 3
          },
          "h1": {
            "buys": 10,
            "sells": 3,
            "buyers": 7,
            "sellers": 3
          },
          "h6": {
            "buys": 90,
            "sells": 103,
            "buyers": 60,
            "sellers": 74
          },
          "h24": {
            "buys": 718,
            "sells": 756,
            "buyers": 449,
            "sellers": 478
          }
        },
        "volume_usd": {
          "m5": "95.7039366558",
          "m15": "101.6537126364",
          "m30": "412.9239965688",
          "h1": "418.5146583339",
          "h6": "21670.2337988852",
          "h24": "196594.914390978"
        },
        "reserve_in_usd": "378242.8559",
        "last_trade_timestamp": "1790730702"
      },
      "relationships": {
        "base_token": {
          "data": {
            "id": "solana_8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "solana_So11111111111111111111111111111111111111112",
            "type": "token"
          }
        },
        "dex": {
          "data": {
            "id": "pumpswap",
            "type": "dex"
          }
        }
      }
    }
  ]
}

Notes

Addresses not found in GeckoTerminal will be ignored.
Returns the top most liquid pool per token, ranked by liquidity (reserve_in_usd) and 24-hour volume (volume_usd).
total_reserve_in_usd represents the total reserve of the requested token only across all its pools, not both tokens in a pair.
Unverified token market cap returns null — the displayed value on GeckoTerminal may match FDV and might not be accurate. Verified market cap is sourced from CoinGecko and may exceed FDV if it includes tokens on other networks.
Use include=top_pools to include top pools data. Add include_composition=true to surface balance and liquidity of base and quote tokens (requires include=top_pools).
Bonding curve tokens (non-graduated launchpad tokens) include a launchpad_details object with graduation status.

For token metadata (socials, websites, description), use Token Info instead.

SDK Examples

const response = await client.onchain.networks.tokens.getAddress('0xdac17f958d2ee523a2206206994597c13d831ec7', {
  network: 'eth',
});

console.log(JSON.stringify(response, null, 2));

response = client.onchain.networks.tokens.get_address(
  "0xdac17f958d2ee523a2206206994597c13d831ec7",
  network="eth",
)

print(response.model_dump_json(indent=2))

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

network

string

default:solana

required

Network ID. *refers to /onchain/networks.

address

string

default:8J69rbLTzWWgUJziFY8jeu5tDwEPBwUz4pKBMr5rpump

required

Token contract address.

Query Parameters

include

enum<string>

Attributes to include.

Available options:

top_pools

include_composition

boolean

Include pool composition. Default: false

include_inactive_source

boolean

Include token data from inactive pools using the most recent swap. Default: false

Response

200 - application/json

Token data

data

object

required

Hide child attributes

data.id

string

required

Token identifier

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.address

string

required

Token contract address

data.attributes.name

string

required

Token name

data.attributes.symbol

string

required

Token symbol

data.attributes.decimals

integer

required

Token decimals

data.attributes.image_url

string | null

required

Token image URL

data.attributes.coingecko_coin_id

string | null

required

CoinGecko coin ID

data.attributes.total_supply

string

required

Token total supply

data.attributes.normalized_total_supply

string

required

Normalized token total supply

data.attributes.price_usd

string | null

required

Token price in USD

data.attributes.fdv_usd

string | null

required

Fully diluted valuation in USD

data.attributes.total_reserve_in_usd

string

required

Total reserve in USD across all pools

data.attributes.volume_usd

object

required

Volume in USD

Hide child attributes

data.attributes.volume_usd.h24

string

data.attributes.market_cap_usd

string | null

required

Market cap in USD

data.attributes.last_trade_timestamp

string

Last trade timestamp in UNIX

data.attributes.launchpad_details

object

Launchpad details for pump-style tokens

Hide child attributes

data.attributes.launchpad_details.graduation_percentage

number

data.attributes.launchpad_details.completed

boolean

data.attributes.launchpad_details.completed_at

string | null

data.attributes.launchpad_details.migrated_destination_pool_address

string | null

data.relationships

object

required

Hide child attributes

data.relationships.top_pools

object

Hide child attributes

data.relationships.top_pools.data

object[]

Hide child attributes

data.relationships.top_pools.data.id

string

data.relationships.top_pools.data.type

string

included

object[]

Included top pool data, present when include=top_pools is specified

Hide child attributes

included.id

string

included.type

string

included.attributes

object

Hide child attributes

included.attributes.base_token_price_usd

string

included.attributes.base_token_price_native_currency

string

included.attributes.base_token_balance

string

Base token balance in pool

included.attributes.base_token_liquidity_usd

string

Base token liquidity in USD

included.attributes.quote_token_price_usd

string

included.attributes.quote_token_price_native_currency

string

included.attributes.quote_token_balance

string

Quote token balance in pool

included.attributes.quote_token_liquidity_usd

string

Quote token liquidity in USD

included.attributes.base_token_price_quote_token

string

included.attributes.quote_token_price_base_token

string

included.attributes.address

string

included.attributes.name

string

included.attributes.pool_created_at

string

included.attributes.token_price_usd

string

included.attributes.fdv_usd

string | null

included.attributes.market_cap_usd

string | null

included.attributes.price_change_percentage

object

Hide child attributes

included.attributes.price_change_percentage.m5

string

included.attributes.price_change_percentage.m15

string

included.attributes.price_change_percentage.m30

string

included.attributes.price_change_percentage.h1

string

included.attributes.price_change_percentage.h6

string

included.attributes.price_change_percentage.h24

string

included.attributes.transactions

object

Hide child attributes

included.attributes.transactions.m5

object

Hide child attributes

included.attributes.transactions.m5.buys

integer

included.attributes.transactions.m5.sells

integer

included.attributes.transactions.m5.buyers

integer

included.attributes.transactions.m5.sellers

integer

included.attributes.transactions.m15

object

Hide child attributes

included.attributes.transactions.m15.buys

integer

included.attributes.transactions.m15.sells

integer

included.attributes.transactions.m15.buyers

integer

included.attributes.transactions.m15.sellers

integer

included.attributes.transactions.m30

object

Hide child attributes

included.attributes.transactions.m30.buys

integer

included.attributes.transactions.m30.sells

integer

included.attributes.transactions.m30.buyers

integer

included.attributes.transactions.m30.sellers

integer

included.attributes.transactions.h1

object

Hide child attributes

included.attributes.transactions.h1.buys

integer

included.attributes.transactions.h1.sells

integer

included.attributes.transactions.h1.buyers

integer

included.attributes.transactions.h1.sellers

integer

included.attributes.transactions.h6

object

Hide child attributes

included.attributes.transactions.h6.buys

integer

included.attributes.transactions.h6.sells

integer

included.attributes.transactions.h6.buyers

integer

included.attributes.transactions.h6.sellers

integer

included.attributes.transactions.h24

object

Hide child attributes

included.attributes.transactions.h24.buys

integer

included.attributes.transactions.h24.sells

integer

included.attributes.transactions.h24.buyers

integer

included.attributes.transactions.h24.sellers

integer

included.attributes.volume_usd

object

Hide child attributes

included.attributes.volume_usd.m5

string

included.attributes.volume_usd.m15

string

included.attributes.volume_usd.m30

string

included.attributes.volume_usd.h1

string

included.attributes.volume_usd.h6

string

included.attributes.volume_usd.h24

string

included.attributes.reserve_in_usd

string

included.attributes.last_trade_timestamp

string

included.relationships

object

Hide child attributes

included.relationships.base_token

object

Hide child attributes

included.relationships.base_token.data

object

Hide child attributes

included.relationships.base_token.data.id

string

included.relationships.base_token.data.type

string

included.relationships.quote_token

object

Hide child attributes

included.relationships.quote_token.data

object

Hide child attributes

included.relationships.quote_token.data.id

string

included.relationships.quote_token.data.type

string

included.relationships.dex

object

Hide child attributes

included.relationships.dex.data

object

Hide child attributes

included.relationships.dex.data.id

string

included.relationships.dex.data.type

string

CoinGecko API

Onchain API

Token Data by Token Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples