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
GET/v2/coins/{slug}Fetch a single coin

GET/v2/coins

List 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 substring 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.
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 "x-api-key: $COINMARKETCAL_API_KEY" \
  -H "Accept: application/json"

◆ Example response

{
  "data": [
    {
      "slug": "bitcoin",
      "symbol": "BTC",
      "name": "Bitcoin",
      "rank": 1,
      "tracked": true,
      "iconUrl": "https://coinmarketcal-share.s3.eu-west-1.amazonaws.com/coins/icons/bitcoin.png",
      "upcomingCount": 12,
      "majorCount": 3,
      "peakImpact": 9.2
    }
  ],
  "meta": {
    "total": 4127,
    "limit": 50,
    "cursor": "eyJyYW5rIjo1MH0"
  }
}

◆ Try it

API keysent as `x-api-key` · saved locally

Loading your keys…

qquery · stringtrackedquery · booleanlimitquery · integercursorquery · string

Live request. Counts against your plan's rate limit.

→ https://api.coinmarketcal.com/v2/coins

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).