GET
/
coins
/
{id}
/
tickers
Coin Tickers by ID
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/{id}/tickers \
  --header 'x-cg-pro-api-key: <api-key>'
{
  "name": "Bitcoin",
  "tickers": [
    {
      "base": "BTC",
      "target": "USDT",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false,
        "logo": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274"
      },
      "last": 69476,
      "volume": 20242.03975,
      "cost_to_move_up_usd": 19320706.3958517,
      "cost_to_move_down_usd": 16360235.3694131,
      "converted_last": {
        "btc": 1.000205,
        "eth": 20.291404,
        "usd": 69498
      },
      "converted_volume": {
        "btc": 20249,
        "eth": 410802,
        "usd": 1406996874
      },
      "trust_score": "green",
      "bid_ask_spread_percentage": 0.010014,
      "timestamp": "2024-04-08T04:02:01+00:00",
      "last_traded_at": "2024-04-08T04:02:01+00:00",
      "last_fetch_at": "2024-04-08T04:03:00+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
      "token_info_url": null,
      "coin_id": "bitcoin",
      "target_coin_id": "tether"
    }
  ]
}

Tips

  • You may obtain the coin ID (API ID) via several ways:
    • refers to respective coin page and find ‘API ID’.
    • refers to /coins/list endpoint.
    • refers to google sheets here.
  • You may specify the exchange_ids if you want to retrieve tickers for specific exchange only.
  • You may include values such as page to specify which page of responses you would like to show.
  • You may also flag to include more data such as exchange logo and depth.

Note

  • The tickers are paginated to 100 items.
  • When dex_pair_format=symbol, the DEX pair base and target are displayed in symbol format (e.g. WETH, USDC) instead of as contract addresses.
  • When order is sorted by volume, converted_volume will be used instead of volume.
  • Cache / Update Frequency: every 2 minutes for all the API plans.

Authorizations

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

Path Parameters

id
string
default:bitcoin
required

coin ID *refers to /coins/list.

Example:

"bitcoin"

Query Parameters

exchange_ids
string
default:binance

exchange ID *refers to /exchanges/list.

Example:

"binance"

include exchange logo, default: false

page
number

page through results

order
enum<string>

use this to sort the order of responses, default: trust_score_desc

Available options:
trust_score_desc,
trust_score_asc,
volume_desc,
volume_asc
depth
boolean

include 2% orderbook depth, ie. cost_to_move_up_usd and cost_to_move_down_usd Default: false

dex_pair_format
enum<string>

set to symbol to display DEX pair base and target as symbols, default: contract_address

Available options:
contract_address,
symbol

Response

200 - application/json

Get coin tickers

The response is of type object.