Skip to main content
GET
Coin Data by Token Address

Notes

  • Find a token’s contract address on its CoinGecko page or via Coins List with include_platform=true.
  • Coin descriptions may contain \r\n escape sequences that require processing for proper formatting.

SDK Examples

Authorizations

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

Learn how to set up your API key

Path Parameters

id
string
default:ethereum
required

Asset platform ID. *refers to /asset_platforms.

contract_address
string
default:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
required

The contract address of token.

Response

200 - application/json

Coin data by token contract address

id
string
required

Coin ID

symbol
string
required

Coin symbol

name
string
required

Coin name

web_slug
string
required

Coin web slug

asset_platform_id
string | null
required

Coin asset platform ID

platforms
object
required

Coin asset platform and contract address

detail_platforms
object
required

Detailed coin asset platform and contract address

block_time_in_minutes
number
required

Blockchain block time in minutes

hashing_algorithm
string | null
required

Blockchain hashing algorithm

categories
string[]
required

Coin categories

preview_listing
boolean
required

Preview listing coin

public_notice
string | null
required

Public notice

additional_notices
string[]
required

Additional notices

has_supply_breakdown
boolean
required

Whether detailed supply breakdown data is available via /coins/supply_breakdown

description
object
required

Coin description

Links

image
object
required

Coin image URL

country_origin
string
required

Country of origin

genesis_date
string | null
required

Genesis date

contract_address
string
required

Coin contract address

sentiment_votes_up_percentage
number | null
required

Sentiment votes up percentage

sentiment_votes_down_percentage
number | null
required

Sentiment votes down percentage

watchlist_portfolio_users
number
required

Number of users watching this coin in portfolio

market_cap_rank
integer | null
required

Market cap rank

market_cap_rank_with_rehypothecated
integer | null
required

Market cap rank including rehypothecated tokens

status_updates
object[]
required

Status updates

last_updated
string
required

Last updated timestamp

localization
object

Coin name localization

market_data
object

Market data

community_data
object

Community data

developer_data
object

Developer data

tickers
object[]

Tickers