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

Derivatives coin screener

Derivatives coin screener (price, OI, funding, RSI, long/short, liquidations; filterable)

GET/api/derivatives/coins

Request

Query parameters

NameTypeRequiredDefaultAllowed valuesDescription
limitintegerOptional50≤ 500Number of rows to return. Example: 50
offsetintegerOptional0—Pagination offset.
onlyWatchliststringOptional—1=1 restricts to the caller watchlist (JWT required, uncached).
exchangesstringOptional——Comma-separated exchange whitelist (27 venues); 400 if none valid.
minMarketCapnumberOptional——Filter: minimum market cap (USD).
maxMarketCapnumberOptional——Filter: maximum market cap (USD).
minOinumberOptional——Filter: minimum open interest (USD).
maxOinumberOptional——Filter: maximum open interest (USD).
minFundingnumberOptional——Filter: minimum funding rate.
maxFundingnumberOptional——Filter: maximum funding rate.
minRsi1hnumberOptional——Filter: minimum 1h RSI.
maxRsi1hnumberOptional——Filter: maximum 1h RSI.
minRsi4hnumberOptional——Filter: minimum 4h RSI.
maxRsi4hnumberOptional——Filter: maximum 4h RSI.
minRsi1dnumberOptional——Filter: minimum 1d RSI.
maxRsi1dnumberOptional——Filter: maximum 1d RSI.
minChangePctnumberOptional——Filter: minimum 24h change (%).
maxChangePctnumberOptional——Filter: maximum 24h change (%).
minVolumenumberOptional——Filter: minimum 24h volume (USD).
maxVolumenumberOptional——Filter: maximum 24h volume (USD).
minLiq24hnumberOptional——Filter: minimum 24h liquidations (USD).
maxLiq24hnumberOptional——Filter: maximum 24h liquidations (USD).
minLsAccountnumberOptional——Filter: minimum account long/short ratio.
maxLsAccountnumberOptional——Filter: maximum account long/short ratio.
minOiChg1hnumberOptional——Filter: minimum 1h OI change (%).
maxOiChg1hnumberOptional——Filter: maximum 1h OI change (%).
minOiChg24hnumberOptional——Filter: minimum 24h OI change (%).
maxOiChg24hnumberOptional——Filter: maximum 24h OI change (%).

Example request

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

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 }`.
nownumbermsServer time when the response was built.
totalnumber—Total.
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[].market_capnumber—Market capitalisation.
data[].pricenumber—Last price in the quote currency (USD or USDT unless stated).
data[].change_pctnumber%Percentage change.
data[].volume_usdnumberUSDVolume in USD notional.
data[].rsi_1hnumber—RSI(14) on 1h candles.
data[].rsi_4hnumber—RSI(14) on 4h candles.
data[].rsi_1dnumber—RSI(14) on daily candles.
data[].basis_pctnumber|null%(futures − spot) / spot × 100.
data[].basis_annual_pctnull% per yearBasis annualised by days to expiry.
data[].oi_usdnumberUSDOpen interest in USD notional.
data[].funding_avgnumber—Average funding rate across exchanges.
data[].ls_accountnumber|null—Long/short ratio by accounts.
data[].ls_takernumber|null—Taker buy/sell ratio.
data[].liq_24h_usdnumberUSD24h liquidations.
data[].oi_chg_1h_pctnumber%1h change of open interest.
data[].oi_chg_24h_pctnumber%24h change of open interest.
data[].vol_chg_24h_pctnumber%24h change of volume.
data[].updated_atnumbermsWhen this row was last updated.

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

Example response

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

  • {
    • "success": true,
    • "now": 1794542257654,
    • "total": 800,
    • "data": [
      • { … 21 },
      • { … 21 }
      ]
    }

Details

Authentication
None. Public endpoint.
Rate limit
1200 requests per minute per IP
Server cache
5s
Edge micro-cache
10s
Update frequency
derived metrics: top 100 coins every 5 min, ranks 101-400 every 15 min, ranks 401-980 every 30 min; tickers every 60 s; live price pushed over WebSocket
Window
latest snapshot (tickers within 1 h)
Data sources
Per-coin derivatives metrics pre-computed in-house from CoinBoss's own exchange collectors (25 sources, e.g. binance, okx, bybit, bitget, gate, hyperliquid); coin names, icons and market cap come from a third-party market-data aggregator.
Exchange coverage
up to 980 coins ranked by aggregated open interest (801 rows at audit time); `exchanges` param restricted to a 27-venue whitelist
Pagination
limit (default 50, max 500)
Sorting
oi_usd desc
Units
oi / volume / liquidations in USD; change and RSI fields as percent / index values; funding as raw fraction; market_cap in USD
Method
oi_usd = cross-exchange open interest (all contract types, multiplier contracts folded); RSI(14) on 1 h / 4 h (aggregated from 1 h) / 1 d klines; oi_chg = change vs hourly archive; liq_24h_usd = 24 h SUM(value_usd); with the `exchanges` param metrics are recomputed at request time for the selected venues
Timestamps
Unix epoch milliseconds (UTC) unless the field description says otherwise
Response format
json
Stability
Stable

Live status

AvailableChecked 2026-11-13 03:57:37 UTCHTTP 20025 msSchema matchesNewest data point 4m old

Availability, last 30 days

100% 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/derivatives/coinsAvailable
Parameters

integer · default 50 · max 500 — Number of rows to return.

integer · default 0 — Pagination offset.

string — =1 restricts to the caller watchlist (JWT required, uncached).

string — Comma-separated exchange whitelist (27 venues); 400 if none valid.

number — Filter: minimum market cap (USD).

number — Filter: maximum market cap (USD).

number — Filter: minimum open interest (USD).

number — Filter: maximum open interest (USD).

number — Filter: minimum funding rate.

number — Filter: maximum funding rate.

number — Filter: minimum 1h RSI.

number — Filter: maximum 1h RSI.

number — Filter: minimum 4h RSI.

number — Filter: maximum 4h RSI.

number — Filter: minimum 1d RSI.

number — Filter: maximum 1d RSI.

number — Filter: minimum 24h change (%).

number — Filter: maximum 24h change (%).

number — Filter: minimum 24h volume (USD).

number — Filter: maximum 24h volume (USD).

number — Filter: minimum 24h liquidations (USD).

number — Filter: maximum 24h liquidations (USD).

number — Filter: minimum account long/short ratio.

number — Filter: maximum account long/short ratio.

number — Filter: minimum 1h OI change (%).

number — Filter: maximum 1h OI change (%).

number — Filter: minimum 24h OI change (%).

number — Filter: maximum 24h OI change (%).

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