API Reference
Log In
API Reference

Coin Price by Token Addresses

get
https://api.coingecko.com/api/v3/simple/token_price/

This endpoint allows you to query one or more token prices using their token contract addresses

👍

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).
  • You may flag to include more data such as market cap, 24hr volume, 24hr change, last updated time etc.
📘

Notes

  • The endpoint returns the global average price of the coin that is aggregated across all active exchanges on CoinGecko.
  • You may cross-check the price on CoinGecko and learn more about our price methodology here.
  • Cache/Update Frequency: every 60 seconds for Public API.
    • Every 20 seconds for Pro-API (Analyst, Lite, Pro, Enterprise).
Path Params
string
required

asset platform's ID
*refers to /asset_platforms.

Query Params
string
required

the contract address of a token

string
required

target currency of coins, comma-separated if querying more than 1 currency.
*refers to /simple/supported_vs_currencies.

boolean

include market capitalization, default: false

boolean

include 24hr volume, default: false

boolean

include 24hr change
default: false

boolean

include last updated price time in UNIX , default: false

string
enum

decimal place for currency price value

Response

Updated about 1 year ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 year ago

Did this page help you?