Coin Tickers by ID

curl --request GET \
  --url https://api.coingecko.com/api/v3/coins/{id}/tickers \
  --header 'x-cg-demo-api-key: <api-key>'

{
  "name": "Bitcoin",
  "tickers": [
    {
      "base": "BTC",
      "target": "USDT",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false,
        "logo": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274"
      },
      "last": 76894.07,
      "volume": 13786.06991,
      "cost_to_move_up_usd": 19320706.3958517,
      "cost_to_move_down_usd": 16360235.3694131,
      "converted_last": {
        "btc": 0.99664066,
        "eth": 36.004874,
        "usd": 76856
      },
      "converted_volume": {
        "btc": 13740,
        "eth": 496366,
        "usd": 1059536991
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.010013,
      "timestamp": "2026-05-18T13:37:29+00:00",
      "last_traded_at": "2026-05-18T13:37:29+00:00",
      "last_fetch_at": "2026-05-18T13:37:29+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",
      "coin_mcap_usd": 1544810408447.1313
    }
  ]
}

GET

coins

{id}

tickers

Coin Tickers by ID

curl --request GET \
  --url https://api.coingecko.com/api/v3/coins/{id}/tickers \
  --header 'x-cg-demo-api-key: <api-key>'

{
  "name": "Bitcoin",
  "tickers": [
    {
      "base": "BTC",
      "target": "USDT",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false,
        "logo": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274"
      },
      "last": 76894.07,
      "volume": 13786.06991,
      "cost_to_move_up_usd": 19320706.3958517,
      "cost_to_move_down_usd": 16360235.3694131,
      "converted_last": {
        "btc": 0.99664066,
        "eth": 36.004874,
        "usd": 76856
      },
      "converted_volume": {
        "btc": 13740,
        "eth": 496366,
        "usd": 1059536991
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.010013,
      "timestamp": "2026-05-18T13:37:29+00:00",
      "last_traded_at": "2026-05-18T13:37:29+00:00",
      "last_fetch_at": "2026-05-18T13:37:29+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",
      "coin_mcap_usd": 1544810408447.1313
    }
  ]
}

Notes

Tickers are paginated to 100 items per page.
Use exchange_ids to filter tickers for a specific exchange.
When dex_pair_format=symbol, DEX pair base and target display as symbols (e.g. WETH, USDC) instead of contract addresses.
When sorting by volume, converted_volume is used instead of volume.

SDK Examples

const response = await client.coins.tickers.get('bitcoin');

console.log(JSON.stringify(response, null, 2));

response = client.coins.tickers.get("bitcoin")

print(response.model_dump_json(indent=2))

Authorizations

x-cg-demo-api-key

string

header

required

Learn how to set up your API key

Path Parameters

string

default:bitcoin

required

Coin ID. *refers to /coins/list

Query Parameters

exchange_ids

string

Exchange ID. *refers to /exchanges/list

include_exchange_logo

boolean

Include exchange logo. Default: false

page

integer

Page through results

order

enum<string>

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, i.e. 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

Coin tickers

name

string

required

Coin name

tickers

object[]

required

List of tickers

Hide child attributes

tickers.base

string

required

Ticker base currency

tickers.target

string

required

Ticker target currency

tickers.market

object

required

Exchange information

Hide child attributes

tickers.market.name

string

Exchange name

tickers.market.identifier

string

Exchange identifier

tickers.market.has_trading_incentive

boolean

Exchange trading incentive

tickers.market.logo

string

Exchange logo URL

tickers.last

number

required

Last price

tickers.volume

number

required

Trading volume

tickers.converted_last

object

required

Converted last price

Hide child attributes

tickers.converted_last.btc

number

tickers.converted_last.eth

number

tickers.converted_last.usd

number

tickers.converted_volume

object

required

Converted trading volume

Hide child attributes

tickers.converted_volume.btc

number

tickers.converted_volume.eth

number

tickers.converted_volume.usd

number

tickers.trust_score

string | null

required

Trust score

tickers.bid_ask_spread_percentage

number

required

Bid-ask spread percentage

tickers.timestamp

string

required

Ticker timestamp

tickers.last_traded_at

string

required

Last traded timestamp

tickers.last_fetch_at

string

required

Last fetch timestamp

tickers.is_anomaly

boolean

required

Whether ticker is anomalous

tickers.is_stale

boolean

required

Whether ticker is stale

tickers.trade_url

string

required

Trade URL

tickers.token_info_url

string | null

required

Token info URL

tickers.coin_id

string

required

Base currency coin ID

tickers.target_coin_id

string

required

Target currency coin ID

tickers.coin_mcap_usd

number

required

Coin market cap in USD

tickers.cost_to_move_up_usd

number

Cost to move price up by 2% in USD

tickers.cost_to_move_down_usd

number

Cost to move price down by 2% in USD

CoinGecko API

Onchain API

Coin Tickers by ID

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples