Coin Data by Token Address

get https://api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}

This endpoint allows you to query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin from the CoinGecko coin page based on an asset platform and a particular token contract address

👍
Tips

You may obtain the asset platform and contract address via several ways:

refers to respective coin page and find ‘contract address’.

refers to /coins/list endpoint (include platform = true).

📘
Notes

Coin descriptions may include newline characters represented as \r\n (escape sequences), which may require processing for proper formatting.

Cache / Update Frequency: every 60 seconds for all the API plans.

Response

Response body

object

string

coin ID

symbol

string

coin symbol

name

string

coin name

web_slug

string

coin web slug

asset_platform_id

string

coin asset platform ID

platforms

object

coin asset platform and contract address

Has additional fields

detail_platforms

object

detailed coin asset platform and contract address

Has additional fields

block_time_in_minutes

number

blockchain block time in minutes

hashing_algorithm

string

blockchain hashing algorithm

categories

preview_listing

boolean

preview listing coin

public_notice

string

public notice

additional_notices

array of strings

additional notices

additional_notices

localization

object

coin name localization

Has additional fields

description

object

coin description

Has additional fields

links

object

links

homepage

array of strings

coin website url

homepage

whitepaper

array of strings

coin whitepaper url

whitepaper

blockchain_site

array of strings

coin block explorer url

blockchain_site

official_forum_url

array of strings

coin official forum url

official_forum_url

chat_url

array of strings

coin chat url

chat_url

announcement_url

array of strings

coin announcement url

announcement_url

snapshot_url

string

coin snapshot url

twitter_screen_name

string

coin twitter handle

facebook_username

string

coin facebook username

bitcointalk_thread_identifier

string

coin bitcointalk thread identifier

telegram_channel_identifier

string

coin telegram channel identifier

subreddit_url

string

coin subreddit url

repos_url

object

coin repository url

image

object

coin image url

thumb

string

small

string

large

string

country_origin

string

coin country of origin

genesis_date

date-time

coin genesis date

sentiment_votes_up_percentage

number

coin sentiment votes up percentage

sentiment_votes_down_percentage

number

coin sentiment votes down percentage

market_cap_rank

number

coin rank by market cap

market_data

object

coin market data

current_price

object

coin current price in currency

total_value_locked

number

total value locked

mcap_to_tvl_ratio

number

market cap to total value locked ratio

fdv_to_tvl_ratio

number

fully diluted valuation to total value locked ratio

roi

number

coin return on investment

ath

object

coin all time high (ATH) in currency

ath_change_percentage

object

coin all time high (ATH) change in percentage

ath_date

object

coin all time high (ATH) date

atl

object

coin all time low (atl) in currency

atl_change_percentage

object

coin all time low (atl) change in percentage

atl_date

object

coin all time low (atl) date

market_cap

object

coin market cap in currency

market_cap_rank

number

coin rank by market cap

fully_diluted_valuation

object

coin fully diluted valuation (fdv) in currency

market_cap_fdv_ratio

number

market cap to fully diluted valuation ratio

total_volume

object

coin total trading volume in currency

high_24h

object

coin 24hr price high in currency

low_24h

object

coin 24hr price low in currency

price_change_24h

number

coin 24hr price change in currency

price_change_percentage_24h

number

coin 24hr price change in percentage

price_change_percentage_7d

number

coin 7d price change in percentage

price_change_percentage_14d

number

coin 14d price change in percentage

price_change_percentage_30d

number

coin 30d price change in percentage

price_change_percentage_60d

number

coin 60d price change in percentage

price_change_percentage_200d

number

coin 200d price change in percentage

price_change_percentage_1y

number

coin 1y price change in percentage

market_cap_change_24h

number

coin 24hr market cap change in currency

market_cap_change_percentage_24h

number

coin 24hr market cap change in percentage

price_change_percentage_1h_in_currency

object

coin 1h price change in currency

price_change_percentage_24h_in_currency

object

coin 24hr price change in currency

price_change_percentage_7d_in_currency

object

coin 7d price change in currency

price_change_percentage_14d_in_currency

object

coin 14d price change in currency

price_change_percentage_30d_in_currency

object

coin 30d price change in currency

price_change_percentage_60d_in_currency

object

coin 60d price change in currency

price_change_percentage_200d_in_currency

object

coin 200d price change in currency

price_change_percentage_1y_in_currency

object

coin 1y price change in currency

market_cap_change_24h_in_currency

object

coin 24hr market cap change in currency

market_cap_change_percentage_24h_in_currency

object

coin 24hr market cap change in percentage

total_supply

number

coin total supply

max_supply

number

coin max supply

circulating_supply

number

coin circulating supply

last_updated

date-time

coin market data last updated timestamp

community_data

object

coin community data

facebook_likes

number

coin facebook likes

twitter_followers

number

coin twitter followers

reddit_average_posts_48h

number

coin reddit average posts in 48 hours

reddit_average_comments_48h

number

coin reddit average comments in 48 hours

reddit_subscribers

number

coin reddit subscribers

reddit_accounts_active_48h

number

coin reddit active accounts in 48 hours

telegram_channel_user_count

number

coin telegram channel user count

developer_data

object

coin developer data

forks

number

coin repository forks

stars

number

coin repository stars

subscribers

number

coin repository subscribers

total_issues

number

coin repository total issues

closed_issues

number

coin repository closed issues

pull_requests_merged

number

coin repository pull requests merged

pull_request_contributors

number

coin repository pull request contributors

code_additions_deletions_4_weeks

object

coin code additions and deletions in 4 weeks

commit_count_4_weeks

number

coin repository commit count in 4 weeks

last_4_weeks_commit_activity_series

array of numbers

coin repository last 4 weeks commit activity series

last_4_weeks_commit_activity_series

status_updates

array of objects

coin status updates

status_updates

object

last_updated

date-time

coin last updated timestamp

tickers

array of objects

coin tickers

tickers

object

base

string

coin ticker base currency

target

string

coin ticker target currency

market

object

coin ticker exchange

last

number

coin ticker last price

volume

number

coin ticker volume

converted_last

object

coin ticker converted last price

converted_volume

object

coin ticker converted volume

trust_score

string

coin ticker trust score

bid_ask_spread_percentage

number

coin ticker bid ask spread percentage

timestamp

date-time

coin ticker timestamp

last_traded_at

date-time

coin ticker last traded timestamp

last_fetch_at

date-time

coin ticker last fetch timestamp

is_anomaly

boolean

coin ticker anomaly

is_stale

boolean

coin ticker stale

trade_url

string

coin ticker trade url

token_info_url

string

coin ticker token info url

coin_id

string

coin ticker base currency coin ID

target_coin_id

string

coin ticker target currency coin ID

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.coingecko.com/api/v3/coins/id/contract/contract_address \
3
     --header 'accept: application/json'


xxxxxxxxxx
1806
}
1
{
2
  "id": "usd-coin",
3
  "symbol": "usdc",
4
  "name": "USDC",
5
  "web_slug": "usdc",
6
  "asset_platform_id": "ethereum",
7
  "platforms": {
8
    "ethereum": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
9
    "polkadot": "1337",
10
    "flow": "A.b19436aae4d94622.FiatToken",
11
    "avalanche": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e",
12
    "optimistic-ethereum": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
13
    "stellar": "USDC-GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
14
    "near-protocol": "17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
15
    "hedera-hashgraph": "0.0.456858",
16
    "zksync": "0x1d17cbcf0d6d143135ae902365d2e5e2a16538d4",
17
    "tron": "TEkxiTehnzSmSe2XqrBj4w32RUN966rdz8",
18
    "celo": "0xceba9300f2b948710d2653dd7b07f33a8b32118c",
19
    "arbitrum-one": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
20
    "base": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
21
    "polygon-pos": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
22
    "solana": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
23
  },
24
  "detail_platforms": {
25
    "ethereum": {
26
      "decimal_place": 6,
27
      "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
28
    },
29
    "polkadot": {

Coin Data by Token Address

👍
Tips

📘
Notes

👍Tips

📘Notes

200Get current data for a coin

👍
Tips

📘
Notes