markets: Get coins market data

API: coingecko.com:coingecko-api
Endpoint: /coins/markets
Response format: application/json
Charset: utf-8
Auth: none
Method: GET
Last Status: 200
Latency: 151ms

Description

Get market data for multiple coins in a list format — prices, market caps, volume, price change percentages, and sparkline charts. Ideal for building portfolio trackers, price tables, or market overviews. Supports filtering by specific coins (ids parameter) or getting top coins by market cap. Results can be sorted and paginated.

From spec: List all supported coins price, market cap, volume and market related data (no more than 250 items per request)

Usage Tips

- Default returns top 100 coins by market cap — no `ids` parameter needed for market overview - `vs_currency` is required — specifies the price currency (usd, eur, btc, etc.) - `order` controls sorting: market_cap_desc, market_cap_asc, volume_desc, volume_asc - `per_page` max is 250 — use pagination for larger datasets - Set `sparkline=true` to get 7-day price mini-charts (useful for UI sparklines)

Parameters (8)

category (string, query, optional)

Filter by coin category (refers to /coins/categories/list)

ids (string, query, optional)

Comma-separated cryptocurrency ids. Refers to 'id' field from /coins/list

order (string, query, optional, default: market_cap_desc)

Sort results by field

Constraints: {'enum': ['market_cap_desc', 'volume_desc', 'volume_asc', 'market_cap_asc', 'gecko_desc', 'gecko_asc', 'name_asc', 'name_desc']}

page (integer, query, optional, default: 1)

Page through results

per_page (integer, query, optional, default: 100)

Total results per page (valid values: 1..250)

Constraints: {'minimum': 1, 'maximum': 250}

price_change_percentage (string, query, optional)

Include price change percentage (e.g., '1h,24h,7d,14d,30d,200d,1y')

sparkline (boolean, query, optional, default: False)

Include sparkline 7 days data (true/false)

vs_currency (string, query, required)

The target currency of market data (usd, eur, jpy, etc.)

Examples (3)

Get Coins Market Data openapi-spec

Get market data for Bitcoin and Ethereum in USD

curl 'https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin%2Cethereum&price_change_percentage=24h%2C7d'
import requests

resp = requests.get(
    "https://api.coingecko.com/api/v3/coins/markets",
    params={
        'vs_currency': 'usd',
        'ids': 'bitcoin,ethereum',
        'price_change_percentage': '24h,7d',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("coingecko")
result = api.fetch("coins/markets", vs_currency="usd", ids="bitcoin,ethereum", price_change_percentage="24h,7d")

for item in result:
    print(item)
const resp = await fetch("https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin%2Cethereum&price_change_percentage=24h%2C7d");
const data = await resp.json();
Get coins market data openapi-spec

Get market data for top 100 coins by market cap in USD

curl 'https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd'
import requests

resp = requests.get(
    "https://api.coingecko.com/api/v3/coins/markets",
    params={
        'vs_currency': 'usd',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("coingecko")
result = api.fetch("coins/markets", vs_currency="usd")

for item in result:
    print(item)
const resp = await fetch("https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd");
const data = await resp.json();
Coins List with Market Data openapi-spec 
curl 'https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin&names=Bitcoin&symbols=btc&category=layer-1&price_change_percentage=1h'
import requests

resp = requests.get(
    "https://api.coingecko.com/api/v3/coins/markets",
    params={
        'vs_currency': 'usd',
        'ids': 'bitcoin',
        'names': 'Bitcoin',
        'symbols': 'btc',
        'category': 'layer-1',
        'price_change_percentage': '1h',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("coingecko")
result = api.fetch("coins/markets", vs_currency="usd", ids="bitcoin", names="Bitcoin", symbols="btc", category="layer-1", price_change_percentage="1h")

for item in result:
    print(item)
const resp = await fetch("https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin&names=Bitcoin&symbols=btc&category=layer-1&price_change_percentage=1h");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:41:00.319993 200 151ms
2026-04-16 02:45:02.785594 200 337ms
2026-04-16 01:51:45.060368 200 132ms
2026-04-16 00:37:58.046180 200 256ms
2026-04-15 03:10:28.911308 200 383ms
2026-04-15 02:32:26.181003 200 294ms
2026-04-15 00:54:03.129334 200 149ms
2026-04-14 01:29:24.740929 200 375ms
2026-04-14 01:25:06.058682 200 242ms
2026-04-14 00:55:54.597944 200 139ms
2026-04-12 16:03:27.957488 200 135ms
2026-04-12 13:48:54.821843 200 263ms
2026-04-12 12:48:07.044889 200 126ms
2026-04-10 01:18:12.369023 200 74ms
2026-04-10 01:04:08.967315 200 440ms
2026-04-10 00:09:43.990421 200 184ms
2026-04-09 02:57:11.426228 200 732ms
2026-04-09 01:52:58.751461 200 139ms
2026-04-09 00:54:19.037843 200 391ms
2026-04-06 06:43:57.252203 200 257ms
2026-04-05 19:13:18.826638 200 329ms
2026-04-05 03:03:00.448685 200 201ms
2026-04-05 01:05:24.915986 200 340ms
2026-04-04 03:20:50.472736 200 211ms
2026-04-04 02:50:58.213649 200 257ms
2026-04-03 13:15:51.326174 200 137ms
2026-04-03 12:49:58.868602 200 277ms
2026-03-30 03:09:27.034184 200 248ms
2026-03-30 02:33:41.179542 200 130ms
2026-03-29 13:38:06.448637 200 227ms
2026-03-29 13:35:57.097267 200 117ms
2026-03-23 10:29:54.853423 200 232ms
2026-03-23 09:20:02.608186 200 128ms