Coins List with Market Data

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/markets \
  --header 'x-cg-pro-api-key: <api-key>'

[
  {
    "id": "bitcoin",
    "symbol": "btc",
    "name": "Bitcoin",
    "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
    "current_price": 77671,
    "market_cap": 1555886872303,
    "market_cap_rank": 1,
    "fully_diluted_valuation": 1555914058873,
    "total_volume": 33235034316,
    "high_24h": 78419,
    "low_24h": 76696,
    "price_change_24h": -747.3360347281705,
    "price_change_percentage_24h": -0.95302,
    "market_cap_change_24h": -15184401491.513184,
    "market_cap_change_percentage_24h": -0.9665,
    "circulating_supply": 20030493,
    "total_supply": 20030843,
    "max_supply": 21000000,
    "ath": 126080,
    "ath_change_percentage": -38.39571,
    "ath_date": "2025-10-06T18:57:42.558Z",
    "atl": 67.81,
    "atl_change_percentage": 114443.23093,
    "atl_date": "2013-07-06T00:00:00.000Z",
    "roi": null,
    "last_updated": "2026-05-18T12:49:21.599Z",
    "market_cap_rank_with_rehypothecated": 1,
    "sparkline_in_7d": {
      "price": [
        81045.84776489827,
        81001.73089268175,
        80898.20817826076
      ]
    },
    "price_change_percentage_1h_in_currency": 0.5823392426906319,
    "price_change_percentage_24h_in_currency": -0.9530164743774191,
    "price_change_percentage_7d_in_currency": -4.042267423689584,
    "price_change_percentage_14d_in_currency": -1.5720857443461431,
    "price_change_percentage_30d_in_currency": 1.9453890367549207,
    "price_change_percentage_200d_in_currency": -29.452371850925864,
    "price_change_percentage_1y_in_currency": -25.214612207475373
  }
]

GET

coins

markets

Coins List with Market Data

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/markets \
  --header 'x-cg-pro-api-key: <api-key>'

[
  {
    "id": "bitcoin",
    "symbol": "btc",
    "name": "Bitcoin",
    "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
    "current_price": 77671,
    "market_cap": 1555886872303,
    "market_cap_rank": 1,
    "fully_diluted_valuation": 1555914058873,
    "total_volume": 33235034316,
    "high_24h": 78419,
    "low_24h": 76696,
    "price_change_24h": -747.3360347281705,
    "price_change_percentage_24h": -0.95302,
    "market_cap_change_24h": -15184401491.513184,
    "market_cap_change_percentage_24h": -0.9665,
    "circulating_supply": 20030493,
    "total_supply": 20030843,
    "max_supply": 21000000,
    "ath": 126080,
    "ath_change_percentage": -38.39571,
    "ath_date": "2025-10-06T18:57:42.558Z",
    "atl": 67.81,
    "atl_change_percentage": 114443.23093,
    "atl_date": "2013-07-06T00:00:00.000Z",
    "roi": null,
    "last_updated": "2026-05-18T12:49:21.599Z",
    "market_cap_rank_with_rehypothecated": 1,
    "sparkline_in_7d": {
      "price": [
        81045.84776489827,
        81001.73089268175,
        80898.20817826076
      ]
    },
    "price_change_percentage_1h_in_currency": 0.5823392426906319,
    "price_change_percentage_24h_in_currency": -0.9530164743774191,
    "price_change_percentage_7d_in_currency": -4.042267423689584,
    "price_change_percentage_14d_in_currency": -1.5720857443461431,
    "price_change_percentage_30d_in_currency": 1.9453890367549207,
    "price_change_percentage_200d_in_currency": -29.452371850925864,
    "price_change_percentage_1y_in_currency": -25.214612207475373
  }
]

Notes

Filter by ids, names, symbols, or category. When multiple are provided, priority is: category > ids > names > symbols.
URL-encode spaces in names (e.g. Binance%20Coin).
include_tokens=all only works with symbols lookups, limited to 50 symbols per request.
Maximum of 250 IDs per request. Wildcard searches are not supported.
Use per_page and page to paginate results.

Filter by category using the category param — refer to Coins Categories List for available values.

SDK Examples

const response = await client.coins.markets.get({
  vs_currency: 'usd',
});

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

response = client.coins.markets.get(
  vs_currency="usd",
)

print(response)

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Query Parameters

vs_currency

string

default:usd

required

Target currency of coins and market data. *refers to /simple/supported_vs_currencies

ids

string

default:bitcoin

Coins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list

names

string

default:Bitcoin

Coins' names, comma-separated if querying more than 1 coin.

symbols

string

default:btc

Coins' symbols, comma-separated if querying more than 1 coin.

include_tokens

enum<string>

For symbols lookups, specify all to include all matching tokens. Default top returns top-ranked tokens by market cap or volume.

Available options:

top,

all

Response

200 - application/json

List of coins with market data

string

required

Coin ID

symbol

string

required

Coin symbol

name

string

required

Coin name

image

string

required

Coin image URL

current_price

number | null

required

Current price in target currency

market_cap

number | null

required

Market cap in target currency

market_cap_rank

integer | null

required

Market cap rank

fully_diluted_valuation

number | null

required

Fully diluted valuation in target currency

total_volume

number | null

required

Total trading volume in target currency

high_24h

number | null

required

24-hour price high in target currency

low_24h

number | null

required

24-hour price low in target currency

price_change_24h

number | null

required

24-hour price change in target currency

price_change_percentage_24h

number | null

required

24-hour price change percentage

market_cap_change_24h

number | null

required

24-hour market cap change in target currency

market_cap_change_percentage_24h

number | null

required

24-hour market cap change percentage

circulating_supply

number | null

required

Circulating supply

total_supply

number | null

required

Total supply

max_supply

number | null

required

Max supply

ath

number | null

required

All-time high price in target currency

ath_change_percentage

number | null

required

All-time high change percentage

ath_date

string<date-time> | null

required

All-time high date

atl

number | null

required

All-time low price in target currency

atl_change_percentage

number | null

required

All-time low change percentage

atl_date

string<date-time> | null

required

All-time low date

roi

object | null

required

Return on investment data

Show child attributes

last_updated

string<date-time>

required

Last updated timestamp

market_cap_rank_with_rehypothecated

integer | null

Market cap rank including rehypothecated tokens

sparkline_in_7d

object

Sparkline price data for the last 7 days

Show child attributes

price_change_percentage_1h_in_currency

number | null

1-hour price change percentage in target currency

price_change_percentage_24h_in_currency

number | null

24-hour price change percentage in target currency

price_change_percentage_7d_in_currency

number | null

7-day price change percentage in target currency

price_change_percentage_14d_in_currency

number | null

14-day price change percentage in target currency

price_change_percentage_30d_in_currency

number | null

30-day price change percentage in target currency

price_change_percentage_200d_in_currency

number | null

200-day price change percentage in target currency

price_change_percentage_1y_in_currency

number | null

1-year price change percentage in target currency

Coin Price by Token Addresses Coin Data by ID

​Notes

​SDK Examples

Authorizations

Query Parameters

Response

Notes

SDK Examples