GET /coins/marketsGet 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.
Get market data for multiple coins including price, market cap, volume, and price change.
- 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)
(string, query, optional)
Filter by category
(string, query, optional)
Comma-separated coin IDs to filter by
(string, query, optional, default: market_cap_desc)
Sort order
Constraints: {'enum': ['market_cap_desc', 'market_cap_asc', 'volume_desc', 'volume_asc', 'id_asc', 'id_desc']}
(integer, query, optional, default: 1)
Page number
Constraints: {'minimum': 1}
(integer, query, optional, default: 100)
Number of results per page (1-250)
Constraints: {'minimum': 1, 'maximum': 250}
(string, query, optional)
Include price change percentage (e.g., 1h,24h,7d,14d,30d,200d,1y)
(boolean, query, optional, default: False)
Include sparkline data (7 days)
(string, query, required)
Currency to display prices in (e.g., usd, eur, btc)
| Title | Type | URL | Action |
|---|---|---|---|
| Get Coins Market Data | openapi-spec |
https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin,ethereum&price_change_percentage=24h,7d |
|
| Get coins market data | openapi-spec |
https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd |
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:29:54.853423 | 200 | 232ms | |
| 2026-03-23 09:20:02.608186 | 200 | 128ms |
| When | Old | New |
|---|---|---|
| 2026-03-23 10:29:54.853423 | 3e25a834ab66 |
e6cf1c8e3ba1 |