Coins
Read the coin catalog, filterable by query, rank, and editorial coverage. Use the slug returned here as the canonical coin identifier when filtering events; tickers collide.
◆ Endpoints
GET
/v2/coinsList coins
Returns a paginated list of coins ordered by rank ascending (top-ranked first). Pass the tracked filter only when you need to limit results by editorial coverage.
◆ Parameters
| Field | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | no | Free-text search across name + symbol. Case-insensitive prefix match. |
| tracked | query | boolean | no | Filter by editorial coverage. Omit to return both tracked and untracked coins; set `true` for actively monitored coins only; set `false` for coins outside active coverage only. |
| limit | query | integer | no | Page size (1–200).Default 50 |
| cursor | query | string | no | Opaque pagination cursor. |
◆ Response item
| Field | Type | Description |
|---|---|---|
| slug | string | Stable coin identifier (URL-safe). |
| symbol | string | Trading ticker (e.g. `BTC`). |
| name | string | Display name (e.g. `Bitcoin`). |
| rank | integer | Market-cap rank at last sync. Null when unranked. |
| tracked | boolean | True when editorial monitors this coin. Untracked coins stay searchable and existing events still appear in `GET /v2/events`, but no new events get added. |
| iconUrl | string | URL to the coin icon (PNG, transparent background, ~64×64 source). |
| upcomingCount | integer | Count of upcoming events linked to this coin in the requester's tier window. |
| majorCount | integer | Count of upcoming events with `impact >= 7.5` for this coin in the requester's tier window. Returned only on **Pro+**; `null` on Free / Standard (impact scores are tier-gated). |
| peakImpact | number | Highest `impact` score across the coin's upcoming events. Returned only on **Pro+**; `null` on Free / Standard. |
◆ PaginationMeta
| Field | Type | Description |
|---|---|---|
| total | integer | Total number of records matching the filters. |
| limit | integer | Page size that was applied. |
| cursor | string | Opaque cursor; pass to the next request as `cursor` to fetch the next page. Null on the last page. |
◆ List wrapper
| Field | Type | Description |
|---|---|---|
| data | array<Coin> | Page of coins. |
| meta | object<PaginationMeta> | Pagination metadata. |
◆ Request
curl -X GET "https://api.coinmarketcal.com/v2/coins" \ -H "Authorization: Bearer $COINMARKETCAL_API_KEY" \ -H "Accept: application/json"
◆ Try it
Preview mode. Sample response only — no live API request.
Loading your keys…
Preview · no API quota used.
GET
/v2/coins/{slug}Fetch a single coin
Returns the full coin payload by slug. 404 when the slug doesn't match any coin (tracked or otherwise).
◆ Parameters
| Field | In | Type | Required | Description |
|---|---|---|---|---|
| slug | path | string | yes | Coin slug (e.g. `bitcoin`). Lowercase, URL-safe. |
◆ Response
| Field | Type | Description |
|---|---|---|
| slug | string | Stable coin identifier (URL-safe). |
| symbol | string | Trading ticker (e.g. `BTC`). |
| name | string | Display name (e.g. `Bitcoin`). |
| rank | integer | Market-cap rank at last sync. Null when unranked. |
| tracked | boolean | True when editorial monitors this coin. Untracked coins stay searchable and existing events still appear in `GET /v2/events`, but no new events get added. |
| iconUrl | string | URL to the coin icon (PNG, transparent background, ~64×64 source). |
| upcomingCount | integer | Count of upcoming events linked to this coin in the requester's tier window. |
| majorCount | integer | Count of upcoming events with `impact >= 7.5` for this coin in the requester's tier window. Returned only on **Pro+**; `null` on Free / Standard (impact scores are tier-gated). |
| peakImpact | number | Highest `impact` score across the coin's upcoming events. Returned only on **Pro+**; `null` on Free / Standard. |
◆ Request
curl -X GET "https://api.coinmarketcal.com/v2/coins/{slug}" \ -H "Authorization: Bearer $COINMARKETCAL_API_KEY" \ -H "Accept: application/json"
◆ Try it
Preview mode. Sample response only — no live API request.
Loading your keys…
Preview · no API quota used.