Skip to main content
GET
/
simple
/
token_price
/
{id}
Coin Price by Token Addresses
curl --request GET \
  --url https://api.coingecko.com/api/v3/simple/token_price/{id} \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": {
    "usd": 67187.3358936566,
    "usd_market_cap": 1317802988326.25,
    "usd_24h_vol": 31260929299.5248,
    "usd_24h_change": 3.63727894677354,
    "last_updated_at": 1711356300
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Tips

  • You may obtain the asset platform and contract address via several ways:
    • Refer to respective coin page and find ‘contract address’.
    • Refer 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.

​
Note

  • 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.
  • The maximum number of contract addresses per API call is 515.
  • Cache / Update Frequency:
    • Every 60 seconds for Public API.
    • Every 20 seconds for Pro API (Basic, Analyst, Lite, Pro, Enterprise).

Authorizations

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

Path Parameters

​
id
string
default:ethereum
required

asset platform's ID *refers to /asset_platforms.

Example:

"ethereum"

Query Parameters

​
contract_addresses
string
default:0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
required

the contract address of a token

​
vs_currencies
string
default:usd
required

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

​
include_market_cap
boolean

include market capitalization, default: false

​
include_24hr_vol
boolean

include 24hr volume, default: false

​
include_24hr_change
boolean

include 24hr change default: false

​
include_last_updated_at
boolean

include last updated price time in UNIX , default: false

​
precision
enum<string>

decimal place for currency price value

Available options:
full,
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18

Response

200 - application/json

price(s) of cryptocurrency

​
usd
number

price in USD

​
usd_market_cap
number

market cap in USD

​
usd_24h_vol
number

24hr volume in USD

​
usd_24h_change
number

24hr change in USD

​
last_updated_at
number

last updated timestamp