API Reference / Coins

List coins

Ranked list of every asset in the index with price, market cap, volume, change and supply.

GEThttps://api.coinmico.com/v1/coinsupdates every 10 s

Returns assets ordered by market cap. Each row is the same shape as the market table on coinmico.com: a volume-weighted price measured across the venues we track, 1h/24h/7d/30d change, measured 24h volume, circulating/total/max supply, ATH/ATL and a measured flag.

Rows flagged measured: false are priced from a reference source because fewer than two tracked venues printed a trade in the last window.

Query parameters

limitinteger

Rows per response, 1–250.Default 100

pageinteger

1-based page number. Ignored when offset is set.Default 1

offsetinteger

Rows to skip. Overrides page.Default 0

idsstring

Comma-separated asset ids to fetch instead of the ranked list.

sparklineboolean

Include a 7-day hourly price array per coin.Default false

Response

coins[]object[]

Coin rows, ranked.

coins[].idstring

Stable asset id, e.g. bitcoin.

coins[].symbolstring

Ticker, lower-case.

coins[].current_pricenumber

Volume-weighted price across measured venues.

coins[].market_capnumber

Price × circulating supply.

coins[].total_volumenumber

Measured 24h spot + derivatives volume.

coins[].price_change_percentage_24h_in_currencynumber

Percent change over a rolling 24h window; 1h, 7d and 30d variants also present.

coins[].circulating_supplynumber

Verified circulating supply.

coins[].measuredboolean

True when the price comes from our own trade feed.

page · limit · offsetinteger

The pagination window served.

atinteger

Unix ms timestamp the snapshot was taken.

Every response also carries x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset and x-request-id. See Rate limits.

Errors

401missing_key

No x-api-key header or bearer token on the request.

401invalid_key

The key is unknown or has been revoked.

429quota_exceeded

More than 600 requests this hour. Wait for x-ratelimit-reset seconds.

503unavailable

Market data is temporarily unavailable; retry after a few seconds.

All errors share one shape: { error: { code, message, status } }. See Errors.

Get a coin →

{ "coins": [ { "id": "bitcoin", "symbol": "btc", "name": "Bitcoin", "image": "https://cdn.coinmico.com/coins/bitcoin-3af4e627853c.png", "current_price": 83059.5, "market_cap": 1669194802323.02, "market_cap_rank": 1, "fully_diluted_valuation": 1744249440448.02, "total_volume": 10156209940.64, "high_24h": 83150.34, "low_24h": 82509.22, "price_change_percentage_1h_in_currency": 0.047769, "price_change_percentage_24h_in_currency": 0.575342, "price_change_percentage_7d_in_currency": -1.980662, "price_change_percentage_30d_in_currency": 8.501538, "circulating_supply": 20096375, "total_supply": 20096375, "measured": true, "max_supply": 21000000, "ath": 126080, "ath_change_percentage": -34.121592, "ath_date": "2025-10-06T10:57:42.000Z", "atl": 67.81, "atl_change_percentage": 122388.57 }, { "id": "ethereum", "symbol": "eth", "name": "Ethereum", "image": "/venues/ethereum-mark.webp", "current_price": 2507.48, "market_cap": 306217831062.9, "market_cap_rank": 2, "fully_diluted_valuation": 306217831062.9, "total_volume": 4116246432, "high_24h": 2518.67, "low_24h": 2485.25, "price_change_percentage_1h_in_currency": 0.01331, "price_change_percentage_24h_in_currency": 0.784131, "price_change_percentage_7d_in_currency": -6.669863, "price_change_percentage_30d_in_currency": 2.877378, "circulating_supply": 122121843.65, "total_supply": 122121843.65, "measured": true, "max_supply": null, "ath": 4946.05, "ath_change_percentage": -49.303425, "ath_date": "2025-08-24T11:21:03.000Z", "atl": 0.432979, "atl_change_percentage": 579022.3 } ], "page": 1, "limit": 2, "offset": 0, "at": "2026-10-10T23:33:45.797Z" }