/api/derivatives/coins
GETDisponibile

Screener delle monete sui derivati

Screener delle monete sui derivati (prezzo, OI, finanziamento, RSI, long/short, liquidazioni; filtrabile)

GET/api/derivatives/coins

Richiesta

Parametri di query

NomeTipoObbligatorioPredefinitoValori ammessiDescrizione
limitintegerFacoltativo50≤ 500Numero di righe da restituire. Esempio: 50
offsetintegerFacoltativo0—Offset di paginazione.
onlyWatchliststringFacoltativo—1=1 limita il risultato alla watchlist del chiamante (JWT richiesto, senza cache).
exchangesstringFacoltativo——Whitelist di exchange separati da virgole (27 piattaforme); 400 se nessuno è valido.
minMarketCapnumberFacoltativo——Filtro: capitalizzazione di mercato minima (USD).
maxMarketCapnumberFacoltativo——Filtro: capitalizzazione di mercato massima (USD).
minOinumberFacoltativo——Filtro: open interest minimo (USD).
maxOinumberFacoltativo——Filtro: open interest massimo (USD).
minFundingnumberFacoltativo——Filtro: tasso di finanziamento minimo.
maxFundingnumberFacoltativo——Filtro: tasso di finanziamento massimo.
minRsi1hnumberFacoltativo——Filtro: RSI a 1h minimo.
maxRsi1hnumberFacoltativo——Filtro: RSI a 1h massimo.
minRsi4hnumberFacoltativo——Filtro: RSI a 4h minimo.
maxRsi4hnumberFacoltativo——Filtro: RSI a 4h massimo.
minRsi1dnumberFacoltativo——Filtro: RSI a 1d minimo.
maxRsi1dnumberFacoltativo——Filtro: RSI a 1d massimo.
minChangePctnumberFacoltativo——Filtro: variazione a 24h minima (%).
maxChangePctnumberFacoltativo——Filtro: variazione a 24h massima (%).
minVolumenumberFacoltativo——Filtro: volume a 24h minimo (USD).
maxVolumenumberFacoltativo——Filtro: volume a 24h massimo (USD).
minLiq24hnumberFacoltativo——Filtro: liquidazioni a 24h minime (USD).
maxLiq24hnumberFacoltativo——Filtro: liquidazioni a 24h massime (USD).
minLsAccountnumberFacoltativo——Filtro: rapporto long/short per account minimo.
maxLsAccountnumberFacoltativo——Filtro: rapporto long/short per account massimo.
minOiChg1hnumberFacoltativo——Filtro: variazione dell'OI a 1h minima (%).
maxOiChg1hnumberFacoltativo——Filtro: variazione dell'OI a 1h massima (%).
minOiChg24hnumberFacoltativo——Filtro: variazione dell'OI a 24h minima (%).
maxOiChg24hnumberFacoltativo——Filtro: variazione dell'OI a 24h massima (%).

Richiesta di esempio

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

Campi della risposta

La tabella dei campi è generata da risposte reali, quindi elenca esattamente ciò che l'endpoint restituisce. I percorsi usano a[] per gli elementi di un array e {*} per gli oggetti indicizzati da un nome dinamico, come una moneta o un exchange.

CampoTipoUnitàDescrizione
successboolean—true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`.
nownumbermsOra del server al momento della composizione della risposta.
totalnumber—Totale.
dataarray—Payload.
data[]object—Payload.
data[].coinstring—Simbolo della moneta, in maiuscolo (per esempio BTC).
data[].namestring—Nome.
data[].image_urlstring—Percorso dell'icona sulla stessa origine, servita da CoinBoss; null quando non esiste un'icona verificata.
data[].market_capnumber—Capitalizzazione di mercato.
data[].pricenumber—Ultimo prezzo nella valuta di quotazione (USD o USDT, salvo diversa indicazione).
data[].change_pctnumber%Variazione percentuale.
data[].volume_usdnumberUSDVolume in nozionale USD.
data[].rsi_1hnumber—RSI(14) su candele a 1h.
data[].rsi_4hnumber—RSI(14) su candele a 4h.
data[].rsi_1dnumber—RSI(14) su candele giornaliere.
data[].basis_pctnumber|null%(futures − spot) / spot × 100.
data[].basis_annual_pctnull% per yearBase annualizzata in funzione dei giorni alla scadenza.
data[].oi_usdnumberUSDOpen interest in nozionale USD.
data[].funding_avgnumber—Tasso di finanziamento medio tra gli exchange.
data[].ls_accountnumber|null—Rapporto long/short per account.
data[].ls_takernumber|null—Rapporto acquisti/vendite taker.
data[].liq_24h_usdnumberUSDLiquidazioni a 24h.
data[].oi_chg_1h_pctnumber%Variazione a 1h dell'open interest.
data[].oi_chg_24h_pctnumber%Variazione a 24h dell'open interest.
data[].vol_chg_24h_pctnumber%Variazione a 24h del volume.
data[].updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.

Generata 2026-11-11 23:00 UTC da 1 risposte reali.

Risposta di esempio

/api/derivatives/coins?limit=50 · Risposta reale acquisita 2026-11-13 03:57:37 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: data conteneva 50 elementi.

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

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
5s
Micro-cache edge
10s
Frequenza di aggiornamento
metriche derivate: prime 100 monete ogni 5 min, posizioni 101-400 ogni 15 min, posizioni 401-980 ogni 30 min; ticker ogni 60 s; prezzo in tempo reale inviato via WebSocket
Finestra
ultima istantanea (ticker entro 1 h)
Fonti dei dati
Metriche sui derivati per moneta precalcolate internamente dai collector di CoinBoss sugli exchange (25 fonti, ad es. binance, okx, bybit, bitget, gate, hyperliquid); nomi delle monete, icone e capitalizzazione di mercato provengono da un aggregatore di dati di mercato di terze parti.
Copertura degli exchange
fino a 980 monete classificate per open interest aggregato (801 righe al momento dell'audit); parametro `exchanges` limitato a una whitelist di 27 exchange
Paginazione
limit (predefinito 50, max 500)
Ordinamento
oi_usd decrescente
Unità
oi / volume / liquidations in USD; change and RSI fields as percent / index values; funding as raw fraction; market_cap in USD
Metodo
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
Timestamp
Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
Formato della risposta
json
Stabilità
Stabile

Stato in tempo reale

DisponibileVerificato 2026-11-13 03:57:37 UTCHTTP 20025 msSchema conformeDato più recente risalente a 4m fa

Disponibilità, ultimi 30 giorni

100% di 411 verifiche superate

Errori

Le chiamate non riuscite hanno la stessa struttura su tutti gli endpoint. L'elenco completo è nella pagina degli errori. Errori e limiti di richieste →

CodiceHTTPSignificatoChe cosa fare
INVALID_PARAM400Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto.Non riprovare senza modifiche; correggere la richiesta.
UNAUTHORIZED401L'header `CB-API-KEY` è stato inviato ma la chiave è sconosciuta o revocata. I dati pubblici non richiedono alcuna chiave: rimuovere l'header o usare una chiave valida.Non riprovare senza modifiche.
FORBIDDEN403La route non fa parte dell'API pubblica (interna o riservata agli account).Non riprovare.
NOT_FOUND404Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste.Non riprovare; verificare il percorso e gli identificatori nel catalogo.
RATE_LIMITED429Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere.Attendere `Retry-After`, poi riprovare con backoff.
INTERNAL500Errore imprevisto del server. Il messaggio è volutamente generico; citare `request_id` quando lo si segnala.Riprovare una volta dopo qualche secondo; se persiste, segnalarlo con l'ID della richiesta.
UPSTREAM_FAILED503La fonte di dati alla base di questo endpoint non ha risposto in tempo. Al suo posto non vengono restituiti numeri obsoleti o sostitutivi.Riprovare con backoff; controllare la pagina di stato.
UNAVAILABLE501 / 503Il dataset è temporaneamente non pronto (riscaldamento della cache) oppure l'endpoint non ha ancora una fonte pubblica lecita.Riprovare più tardi; il catalogo contrassegna gli endpoint non disponibili per scelta progettuale.
REQUEST_FAILED200Alcuni endpoint meno recenti rispondono HTTP 200 con `success: false`. Controllare sempre `success`, non solo lo stato HTTP.Dipende dal messaggio; trattare come una richiesta non riuscita.

Prova

GET/api/derivatives/coinsDisponibile
Parametri

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

integer · predefinito 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 (%).

URL della richiestahttps://www.coinboss.com/api/derivatives/coins?limit=50
Scegliere un endpoint e premere «Invia richiesta». La risposta, gli header e i tempi compariranno qui.