Screener delle monete sui derivati
Screener delle monete sui derivati (prezzo, OI, finanziamento, RSI, long/short, liquidazioni; filtrabile)
/api/derivatives/coinsRichiesta
Parametri di query
| Nome | Tipo | Obbligatorio | Predefinito | Valori ammessi | Descrizione |
|---|---|---|---|---|---|
| limit | integer | Facoltativo | 50 | ≤ 500 | Numero di righe da restituire. Esempio: 50 |
| offset | integer | Facoltativo | 0 | — | Offset di paginazione. |
| onlyWatchlist | string | Facoltativo | — | 1 | =1 limita il risultato alla watchlist del chiamante (JWT richiesto, senza cache). |
| exchanges | string | Facoltativo | — | — | Whitelist di exchange separati da virgole (27 piattaforme); 400 se nessuno è valido. |
| minMarketCap | number | Facoltativo | — | — | Filtro: capitalizzazione di mercato minima (USD). |
| maxMarketCap | number | Facoltativo | — | — | Filtro: capitalizzazione di mercato massima (USD). |
| minOi | number | Facoltativo | — | — | Filtro: open interest minimo (USD). |
| maxOi | number | Facoltativo | — | — | Filtro: open interest massimo (USD). |
| minFunding | number | Facoltativo | — | — | Filtro: tasso di finanziamento minimo. |
| maxFunding | number | Facoltativo | — | — | Filtro: tasso di finanziamento massimo. |
| minRsi1h | number | Facoltativo | — | — | Filtro: RSI a 1h minimo. |
| maxRsi1h | number | Facoltativo | — | — | Filtro: RSI a 1h massimo. |
| minRsi4h | number | Facoltativo | — | — | Filtro: RSI a 4h minimo. |
| maxRsi4h | number | Facoltativo | — | — | Filtro: RSI a 4h massimo. |
| minRsi1d | number | Facoltativo | — | — | Filtro: RSI a 1d minimo. |
| maxRsi1d | number | Facoltativo | — | — | Filtro: RSI a 1d massimo. |
| minChangePct | number | Facoltativo | — | — | Filtro: variazione a 24h minima (%). |
| maxChangePct | number | Facoltativo | — | — | Filtro: variazione a 24h massima (%). |
| minVolume | number | Facoltativo | — | — | Filtro: volume a 24h minimo (USD). |
| maxVolume | number | Facoltativo | — | — | Filtro: volume a 24h massimo (USD). |
| minLiq24h | number | Facoltativo | — | — | Filtro: liquidazioni a 24h minime (USD). |
| maxLiq24h | number | Facoltativo | — | — | Filtro: liquidazioni a 24h massime (USD). |
| minLsAccount | number | Facoltativo | — | — | Filtro: rapporto long/short per account minimo. |
| maxLsAccount | number | Facoltativo | — | — | Filtro: rapporto long/short per account massimo. |
| minOiChg1h | number | Facoltativo | — | — | Filtro: variazione dell'OI a 1h minima (%). |
| maxOiChg1h | number | Facoltativo | — | — | Filtro: variazione dell'OI a 1h massima (%). |
| minOiChg24h | number | Facoltativo | — | — | Filtro: variazione dell'OI a 24h minima (%). |
| maxOiChg24h | number | Facoltativo | — | — | 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.
| Campo | Tipo | Unità | Descrizione |
|---|---|---|---|
| success | boolean | — | true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`. |
| now | number | ms | Ora del server al momento della composizione della risposta. |
| total | number | — | Totale. |
| data | array | — | Payload. |
| data[] | object | — | Payload. |
| data[].coin | string | — | Simbolo della moneta, in maiuscolo (per esempio BTC). |
| data[].name | string | — | Nome. |
| data[].image_url | string | — | Percorso dell'icona sulla stessa origine, servita da CoinBoss; null quando non esiste un'icona verificata. |
| data[].market_cap | number | — | Capitalizzazione di mercato. |
| data[].price | number | — | Ultimo prezzo nella valuta di quotazione (USD o USDT, salvo diversa indicazione). |
| data[].change_pct | number | % | Variazione percentuale. |
| data[].volume_usd | number | USD | Volume in nozionale USD. |
| data[].rsi_1h | number | — | RSI(14) su candele a 1h. |
| data[].rsi_4h | number | — | RSI(14) su candele a 4h. |
| data[].rsi_1d | number | — | RSI(14) su candele giornaliere. |
| data[].basis_pct | number|null | % | (futures − spot) / spot × 100. |
| data[].basis_annual_pct | null | % per year | Base annualizzata in funzione dei giorni alla scadenza. |
| data[].oi_usd | number | USD | Open interest in nozionale USD. |
| data[].funding_avg | number | — | Tasso di finanziamento medio tra gli exchange. |
| data[].ls_account | number|null | — | Rapporto long/short per account. |
| data[].ls_taker | number|null | — | Rapporto acquisti/vendite taker. |
| data[].liq_24h_usd | number | USD | Liquidazioni a 24h. |
| data[].oi_chg_1h_pct | number | % | Variazione a 1h dell'open interest. |
| data[].oi_chg_24h_pct | number | % | Variazione a 24h dell'open interest. |
| data[].vol_chg_24h_pct | number | % | Variazione a 24h del volume. |
| data[].updated_at | number | ms | Momento 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"
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
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 →
| Codice | HTTP | Significato | Che cosa fare |
|---|---|---|---|
| INVALID_PARAM | 400 | Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto. | Non riprovare senza modifiche; correggere la richiesta. |
| UNAUTHORIZED | 401 | L'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. |
| FORBIDDEN | 403 | La route non fa parte dell'API pubblica (interna o riservata agli account). | Non riprovare. |
| NOT_FOUND | 404 | Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste. | Non riprovare; verificare il percorso e gli identificatori nel catalogo. |
| RATE_LIMITED | 429 | Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere. | Attendere `Retry-After`, poi riprovare con backoff. |
| INTERNAL | 500 | Errore 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_FAILED | 503 | La 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. |
| UNAVAILABLE | 501 / 503 | Il 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_FAILED | 200 | Alcuni 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
/api/derivatives/coinsDisponibileinteger · 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 (%).
https://www.coinboss.com/api/derivatives/coins?limit=50Altro in questa categoria
- Pacchetto completo di una moneta (OI, finanziamento, liquidazioni, volume, long/short) /api/sd/coin
- Volume dei futures di una moneta /api/sd/volume
- Screener delle monete sui derivati /api/derivatives/coins
- Tabella completa delle monete sui derivati /api/derivatives/coins-full
- Candele dei derivati di una moneta /api/derivatives/kline
- Elenco dell'RSI per moneta /api/derivatives/rsi
- Serie MACD di una moneta /api/indicators/ta/macd/:coin
- Serie storiche di una moneta /api/market/history
- Ticker dei derivati aggregati per moneta /api/market/tickers
- Classifica del volume dei derivati /api/market/volume-rank