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

Total crypto market cap and major-coin cap history

Total crypto market cap and major-coin cap history

GET/api/indicators/marketcap

Request

This endpoint takes no parameters.

Example request

curl -s "https://www.coinboss.com/api/indicators/marketcap"

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 }`.
updated_atnumbermsWhen this row was last updated.
coverageobject—What is included and what is missing.
coverage.coinsnumber—Coins.
coverage.notestring—Note.
total_mcapnumberUSDSum of the market caps of the tracked coins (rows refreshed within 24 hours, upstream anomalies excluded).
vol_24hnumberUSDSum of the 24h trading volume of the same coins.
breakdownobject—Split of `total_mcap` into BTC, ETH, stablecoins and all other coins, in USD and as percentages.
breakdown.btcnumber—Value for BTC.
breakdown.ethnumber—Value for ETH.
breakdown.stablenumberUSDCombined market cap of the listed major stablecoins (USDT, USDC, DAI and others).
breakdown.altnumberUSD`total_mcap` minus BTC, ETH and stablecoins.
breakdown.btc_pctnumber%BTC market cap ÷ `total_mcap` × 100.
breakdown.eth_pctnumber%ETH market cap ÷ `total_mcap` × 100.
breakdown.stable_pctnumber%`breakdown.stable` ÷ `total_mcap` × 100.
breakdown.alt_pctnumber%`breakdown.alt` ÷ `total_mcap` × 100.
top10array—Top ten entries.
top10[]object—Top ten entries.
top10[].coinstring—Coin symbol, upper case (for example BTC).
top10[].mcapnumber—Market capitalisation.
top10[].sharenumber—Share of the total.
historyarray—Historical points, oldest first unless stated.
history[]object—Historical points, oldest first unless stated.
history[].datestring—Calendar date (UTC).
history[].totalnumber—Total.
history[].btcnumber—Value for BTC.
history[].ethnumber—Value for ETH.
history[].stablenumberUSDStablecoin market cap in that day's own snapshot.
dominance_historyarray—Dominance over time.
dominance_history[]array—Dominance over time.
dominance_history[][]number—Dominance over time.

Generated 2026-11-11 23:01 UTC from 1 real responses.

Example response

/api/indicators/marketcap · Real response captured 2026-11-13 03:59:25 UTC. Long arrays and maps are shortened for display: top10 had 10 items; history had 98 items; dominance_history had 1340 items.

  • {
    • "success": true,
    • "updated_at": 1794541978352,
    • "coverage": {
      • "coins": 2214,
      • "note": "CoinGecko top-listed coins only; rows refreshed within 24h; rows with market cap > $10B and 24h turnover < 0.0001% are excluded as upstream anomalies"
      },
    • "total_mcap": 2419216305601.422,
    • "vol_24h": 130272448234.72011,
    • "breakdown": {
      • "btc": 1388749788148,
      • "eth": 238606491245,
      • "stable": 273094600801,
      • "alt": 518765425407.4219,
      • "btc_pct": 57.4,
      • "eth_pct": 9.86,
      • "stable_pct": 11.29,
      • "alt_pct": 21.44
      },
    • "top10": [
      • { … 3 },
      • { … 3 }
      ],
    • "history": [
      • { … 5 },
      • { … 5 }
      ],
    • "dominance_history": [
      • [ … 2 ],
      • [ … 2 ]
      ]
    }

Details

Authentication
None. Public endpoint.
Rate limit
1200 requests per minute per IP
Server cache
10m
Edge micro-cache
10s
Update frequency
third-party market-data aggregator every 10 min; daily history point appended on request; dominance history daily; API cache 600 s
Window
current snapshot; own daily history since 2026-07-05
Data sources
Total crypto market cap and its BTC / ETH / stablecoin / altcoin breakdown computed from third-party market-data aggregator market caps; long-run BTC dominance history from bitcoin-data.com.
Exchange coverage
About 2,200 coins passing the freshness and outlier guard
Pagination
none
Units
USD; shares in percent
Method
total = SUM(market cap) over rows refreshed within 24h, excluding outliers (mcap > 10B USD with 24h volume < mcap * 1e-6); alt = total - btc - eth - stable (15 symbols)
Timestamps
Unix epoch milliseconds (UTC) unless the field description says otherwise
Response format
json
Stability
Stable

Live status

AvailableChecked 2026-11-13 03:59:25 UTCHTTP 2001 msSchema matchesNewest data point 6m old

Availability, last 30 days

100% of 408 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/indicators/marketcapAvailable
Parameters

No parameters.

Request URLhttps://www.coinboss.com/api/indicators/marketcap
Choose an endpoint and press “Send request”. The response, headers and timing will appear here.