GETAvailable
Stablecoin list
Stablecoin list (market cap and changes)
GET
/api/stablecoins/listRequest
This endpoint takes no parameters.
Example request
curl -s "https://www.coinboss.com/api/stablecoins/list"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.
| Field | Type | Unit | Description |
|---|---|---|---|
| success | boolean | — | true when the request succeeded. On failure the body is `{ success: false, code, error, request_id }`. |
| updated_at | number | ms | When this row was last updated. |
| total_mcap_usd | number | USD | Sum of the circulating value of the listed stablecoins (the 100 largest). |
| total_change_24h_pct | number | % | Change of `total_mcap_usd` against the sum of the same coins' previous-day values from the source; null when unavailable. |
| usdt_dominance_pct | number | % | USDT circulating value ÷ `total_mcap_usd` × 100; null when USDT is missing. |
| count | number | — | Number of items. |
| data | array | — | Payload. |
| data[] | object | — | Payload. |
| data[].id | string(decimal) | — | Identifier. |
| data[].symbol | string | — | Instrument symbol as normalised by CoinBoss (for example BTCUSDT). |
| data[].name | string | — | Name. |
| data[].gecko_id | string | — | Identifier of the coin at a public market-data aggregator, passed through from the source; can be null. |
| data[].mechanism | string | — | Peg mechanism as classified by the source: `fiat-backed`, `crypto-backed` or `algorithmic`. |
| data[].price | number|null | — | Last price in the quote currency (USD or USDT unless stated). |
| data[].depeg | string | — | Peg state against 1 USD: `ok` within 0.5 %, `warn` beyond 0.5 %, `depeg` beyond 2 %, `unknown` when no price is available. |
| data[].depeg_pct | number|null | % | Deviation of `price` from 1 USD: (price − 1) × 100; null when no price is available. |
| data[].mcap_usd | number | USD | Market capitalisation. |
| data[].share_pct | number | % | Share of the total. |
| data[].change_24h_pct | number|null | % | 24h percentage change. |
| data[].change_7d_pct | number|null | % | 7-day percentage change. |
| data[].change_30d_pct | number|null | % | Change of circulating value against the value one month earlier supplied by the source; null when unavailable. |
Generated 2026-11-11 23:01 UTC from 1 real responses.
Example response
/api/stablecoins/list · Real response captured 2026-11-13 03:53:45 UTC. Long arrays and maps are shortened for display: data had 100 items.
- "success"true
- "updated_at"1794541801623
- "total_mcap_usd"287476086155.35986
- "total_change_24h_pct"-0.54
- "usdt_dominance_pct"60.97
- "count"100
- "data"
Details
- Authentication
- None. Public endpoint.
- Rate limit
- 1200 requests per minute per IP
- Server cache
- 2m
- Edge micro-cache
- 10s
- Update frequency
- every 10 min; API cache 120 s
- Window
- latest; change vs previous day / week / month
- Data sources
- USD-pegged stablecoin supply, price and peg deviation from a third-party source's stablecoins API.
- Exchange coverage
- Top 100 USD-pegged stablecoins by circulating supply (353 tracked)
- Pagination
- fixed LIMIT 100
- Sorting
- circulating_usd desc
- Units
- USD; change in percent
- Method
- change = (circulating - prev) / prev * 100; depeg flag at 0.5% (warning) and 2% (severe) deviation from 1 USD
- Timestamps
- Unix epoch milliseconds (UTC) unless the field description says otherwise
- Response format
- json
- Stability
- Stable
Live status
AvailableChecked 2026-11-13 03:53:45 UTCHTTP 2001 msSchema matchesNewest data point 4m old
Availability, last 30 days
100% of 407 checks passed
Errors
Failed calls share one shape on every endpoint. The full list is on the errors page. Errors and rate limits →
| Code | HTTP | Meaning | What to do |
|---|---|---|---|
| INVALID_PARAM | 400 | A 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. |
| UNAUTHORIZED | 401 | The `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. |
| FORBIDDEN | 403 | The route is not part of the public API (internal or account-only). | Do not retry. |
| NOT_FOUND | 404 | Unknown route, or the requested coin / exchange / fund does not exist. | Do not retry; check the path and identifiers against the catalog. |
| RATE_LIMITED | 429 | More requests than the per-minute limit. `Retry-After` gives the seconds to wait. | Wait for `Retry-After`, then retry with backoff. |
| INTERNAL | 500 | Unexpected 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_FAILED | 503 | The 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. |
| UNAVAILABLE | 501 / 503 | The 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_FAILED | 200 | Some 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/stablecoins/listAvailableParameters
No parameters.
Request URL
https://www.coinboss.com/api/stablecoins/listChoose an endpoint and press “Send request”. The response, headers and timing will appear here.
More in this category
- Global derivatives metrics /api/derivatives/global
- Homepage indicator-card bundle /api/home/indicator-cards
- Homepage macro cards /api/home/macro-cards
- Monthly BTC spot volume /api/indicators/cm/btc-spot-vol-monthly
- Monthly crypto spot volume /api/indicators/cm/crypto-spot-vol-monthly
- Total crypto market cap and major-coin cap history /api/indicators/marketcap
- Crypto market cap split by type /api/indicators/marketcap-type
- Homepage ticker-bar aggregates /api/market/home-ticker
- Derivatives market overview /api/market/overview
- Daily perp-to-spot volume ratio /api/p3/perp-spot-ratio
- Perp vs spot volume /api/p3/perp-spot-volume
- Market-wide volume time series /api/p3/volume/history
- Volume overview /api/p3/volume/overview
- Total stablecoin market-cap history /api/stablecoins/chart
- Stablecoin list /api/stablecoins/list
- BTC dominance history /api/volume/btc-dominance-series
- Global spot / derivatives volume history /api/volume/global-history