24h Volume—Open Interest—24h Liquidations$1.36B24h Long/Short—BTC Dominance—ETH Dominance—
App
Language ▾
$ USD ▾
/api/coins/all
GETAvailable

Full coin list

Full coin list (price, market cap, icon)

GET/api/coins/all
Coin records not updated for more than 48 hours are returned with `market_cap` and `mcap_rank` set to `null` and `is_stale: true`, after all current rows; the other fields of such rows keep their last stored value. The rule is echoed as `stale_rule`.

Request

Query parameters

NameTypeRequiredDefaultAllowed valuesDescription
limitintegerOptional0≤ 20000Row count; 0 = unlimited. Example: 100
offsetintegerOptional0—Pagination offset.
hasMcapstringOptional—1=1 only coins with a market cap.

Example request

curl -s "https://www.coinboss.com/api/coins/all?limit=100"

Response fields

The field table is generated from real responses, so it lists exactly what the endpoint returns. Paths use a[] for array items and {*} for objects keyed by a dynamic name such as a coin or an exchange.

FieldTypeUnitDescription
successboolean—true when the request succeeded. On failure the body is `{ success: false, code, error, request_id }`.
totalnumber—Total.
returnednumbercountNumber of coins in `data` for this request (after `limit`/`offset`); `total` is the size of the whole list.
stale_ruleobject—Rule applied to coins whose reference data has not been refreshed recently.
stale_rule.threshold_hoursnumberhA coin is stale when its reference data is older than this many hours.
stale_rule.basisstring—Futures price minus spot price, or the basis block.
stale_rule.nulled_fieldsarray—Fields returned as `null` for stale coins instead of an outdated value.
stale_rule.nulled_fields[]string—Field name.
stale_rule.flagstring—Name of the per-row boolean that marks a stale coin (`is_stale`).
stale_rule.stale_returnednumbercountNumber of stale coins in this response.
dataarray—Payload.
data[]object—Payload.
data[].coinstring—Coin symbol, upper case (for example BTC).
data[].namestring—Name.
data[].image_urlstring—Same-origin icon path served by CoinBoss; null when no verified icon exists.
data[].pricestring(decimal)—Last price in the quote currency (USD or USDT unless stated).
data[].market_capstring(decimal)—Market capitalisation.
data[].mcap_ranknumber—Rank by market capitalisation.
data[].change_pctstring(decimal)%Percentage change.
data[].volume_usdstring(decimal)USDVolume in USD notional.
data[].circulating_supplystring(decimal)coinCirculating supply of the coin as reported by a third-party source, a decimal string; null when not reported.
data[].total_supplystring(decimal)—Total supply in coins.
data[].max_supplystring(decimal)|null—Maximum supply in coins; null when unlimited or unknown.
data[].athstring(decimal)USDAll-time-high price of the coin as reported by a third-party source, a decimal string.
data[].ath_datestring—Moment the all-time high in `ath` was reached, ISO 8601 UTC.
data[].high_24hstring(decimal)—24h high.
data[].low_24hstring(decimal)—24h low.

Generated 2026-11-11 22:59 UTC from 1 real responses.

Example response

/api/coins/all?limit=100 · Real response captured 2026-11-13 03:57:28 UTC. Long arrays and maps are shortened for display: data had 100 items.

  • {
    • "success": true,
    • "total": 20484,
    • "returned": 100,
    • "stale_rule": {
      • "threshold_hours": 48,
      • "basis": "coins.updated_at",
      • "nulled_fields": [ … 2 ],
      • "flag": "is_stale",
      • "stale_returned": 0
      },
    • "data": [
      • { … 15 },
      • { … 15 }
      ]
    }

Details

Authentication
None. Public endpoint.
Rate limit
1200 requests per minute per IP
Server cache
2m
Edge micro-cache
10s
Update frequency
full list every 6 h, top 2,500 hourly; API cache 120 s
Window
latest; 24h change (third-party market-data aggregator)
Data sources
Full coin master list (price, market cap, rank, supply) from a third-party market-data aggregator's markets API.
Exchange coverage
third-party market-data aggregator full coin list (about 20,400 rows at probe time), including coins without market cap
Pagination
limit (0 = unlimited, max 20000) + offset; hasMcap filter; total returned
Sorting
market cap desc (rows without market cap last)
Units
USD
Timestamps
Unix epoch milliseconds (UTC) unless the field description says otherwise
Response format
json
Stability
Stable

Live status

AvailableChecked 2026-11-13 03:57:28 UTCHTTP 20031 msSchema matches

Availability, last 30 days

99.76% of 411 checks passed

Errors

Failed calls share one shape on every endpoint. The full list is on the errors page. Errors and rate limits →

CodeHTTPMeaningWhat to do
INVALID_PARAM400A required parameter is missing or a value is not accepted. `param` names the parameter when it is known.Do not retry unchanged; fix the request.
UNAUTHORIZED401The `CB-API-KEY` header was sent but the key is unknown or revoked. Public data needs no key — drop the header or use a valid key.Do not retry unchanged.
FORBIDDEN403The route is not part of the public API (internal or account-only).Do not retry.
NOT_FOUND404Unknown route, or the requested coin / exchange / fund does not exist.Do not retry; check the path and identifiers against the catalog.
RATE_LIMITED429More requests than the per-minute limit. `Retry-After` gives the seconds to wait.Wait for `Retry-After`, then retry with backoff.
INTERNAL500Unexpected server error. The message is generic by design; quote `request_id` when reporting it.Retry once after a few seconds; report it with the request id if it persists.
UPSTREAM_FAILED503The data source behind this endpoint did not answer in time. No stale or substitute numbers are returned in its place.Retry with backoff; check the status page.
UNAVAILABLE501 / 503The dataset is temporarily not ready (cache warming) or the endpoint has no lawful public source yet.Retry later; the catalog marks endpoints that are unavailable by design.
REQUEST_FAILED200Some older endpoints answer HTTP 200 with `success: false`. Always check `success`, not only the HTTP status.Depends on the message; treat as a failed request.

Try it

GET/api/coins/allAvailable
Parameters

integer · default 0 · max 20000 — Row count; 0 = unlimited.

integer · default 0 — Pagination offset.

string — =1 only coins with a market cap.

Request URLhttps://www.coinboss.com/api/coins/all?limit=100
Choose an endpoint and press “Send request”. The response, headers and timing will appear here.