Volume 24h—Open Interest—Liquidazioni 24h$1.36BLong/Short 24h—Dominanza BTC—Dominanza ETH—
App
Lingua ▾
€ EUR ▾
/api/sd/coin
GETDisponibile

Pacchetto completo di una moneta (OI, finanziamento, liquidazioni, volume, long/short)

Livello dati proprio: pacchetto completo di una moneta in un'unica chiamata (OI / finanziamento / liquidazioni / volume / long/short, con isolamento dei guasti per blocco)

GET/api/sd/coin

Richiesta

Parametri di query

NomeTipoObbligatorioPredefinitoValori ammessiDescrizione
coinstringObbligatorio——Simbolo della moneta; 400 se mancante. Alias: `base`. Esempio: BTC

Richiesta di esempio

curl -s "https://www.coinboss.com/api/sd/coin?coin=BTC"

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 }`.
coinstring—Simbolo della moneta, in maiuscolo (per esempio BTC).
nownumbermsOra del server al momento della composizione della risposta.
oiobject—Lo stesso oggetto restituito da `/api/sd/oi` per questa moneta.
oi.coinstring—Simbolo della moneta, in maiuscolo (per esempio BTC).
oi.nownumbermsOra del server al momento della composizione della risposta.
oi.total_usdnumberUSDOpen interest su tutti gli exchange e i contratti inclusi, così come lo dichiara ciascun exchange (nozionale USD).
oi.n_exchangesnumber—Numero di exchange nel totale.
oi.n_contractsnumber—Numero di contratti nel totale.
oi.asofnumbermsOra di aggiornamento più recente tra le righe incluse.
oi.total_usd_single_adjustednumberUSD`total_usd` con i valori degli exchange che dichiarano entrambi i lati (`double_sided.exchanges`) dimezzati, in modo che ogni exchange conti un solo lato.
oi.double_sidedobject—Exchange che notoriamente pubblicano l'open interest long + short come un unico numero.
oi.double_sided.exchangesarray—Exchange.
oi.double_sided.exchanges[]string—Exchange.
oi.double_sided.oi_usdnumberUSDOpen interest dichiarato da quegli exchange prima del dimezzamento.
oi.by_kindobject—Ripartizione tra lineari / inversi.
oi.by_kind.linear_usdnumberUSDOpen interest dei contratti lineari (con margine e regolamento in una stablecoin o in USD).
oi.by_kind.inverse_usdnumberUSDOpen interest dei contratti inversi (con margine in coin), convertito in USD al prezzo del contratto.
oi.by_marginobject—Ripartizione per valuta di margine.
oi.by_margin.othernumberUSDAltre valute di margine (per esempio exchange con regolamento in USD come CME).
oi.by_margin.usdtnumberUSDContratti con margine in USDT.
oi.by_margin.usdcnumberUSDContratti con margine in USDC. può essere assente
oi.by_margin.coinnumberUSDContratti con margine in coin. può essere assente
oi.by_contract_typeobject—Ripartizione tra perpetui / a scadenza.
oi.by_contract_type.perpetual_usdnumberUSDContratti perpetui.
oi.by_contract_type.delivery_usdnumberUSDFutures a scadenza (contratti a scadenza).
oi.changeobject—Variazione dell'open interest su 1h / 4h / 24h, calcolata sullo stesso insieme di contratti a entrambi gli estremi. chiavi dinamiche: h1,h4,h24
oi.change.{*}object—Variazione nel periodo indicato.
oi.change.{*}.pctnumber%Variazione percentuale tra `prev` e `cur`.
oi.change.{*}.curnumberUSDSomma attuale sui contratti abbinati.
oi.change.{*}.prevnumberUSDSomma sugli stessi contratti a `prev_ts`.
oi.change.{*}.n_matchednumber—Contratti (o exchange) presenti a entrambi gli estremi.
oi.change.{*}.n_totalnumber—Contratti (o exchange) presenti ora.
oi.change.{*}.matched_share_pctnumber%Quota dell'open interest attuale coperta dall'insieme abbinato. può essere assente
oi.change.{*}.prev_tsnumbermsOra dell'istantanea di confronto.
oi.change.{*}.span_minnumberminDistanza effettiva tra l'istantanea di confronto e il momento attuale.
oi.change.{*}.basisstring—Serie di istantanee da cui proviene il valore di confronto.
oi.change.{*}.frozen_excludedobject—Righe escluse dalla variazione perché il loro valore non è variato tra le due istantanee (fonte non in aggiornamento). può essere assente
oi.change.{*}.frozen_excluded.n_baselinenumber—Elementi nell'istantanea di confronto. può essere assente
oi.change.{*}.frozen_excluded.n_currentnumber—Elementi nell'istantanea attuale. può essere assente
oi.change.{*}.frozen_excluded.cur_usdnumberUSDValore attuale. può essere assente
oi.change.{*}.frozen_excluded.prev_usdnumberUSDValore di confronto. può essere assente
oi.by_exchangearray—Ripartizione per exchange.
oi.by_exchange[]object—Ripartizione per exchange.
oi.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
oi.by_exchange[].oi_usdnumberUSDOpen interest in nozionale USD.
oi.by_exchange[].share_pctnumber%Quota sul totale.
oi.by_exchange[].n_contractsnumber—Numero di contratti.
oi.by_exchange[].linear_usdnumberUSDContratti lineari.
oi.by_exchange[].inverse_usdnumberUSDContratti inversi (con margine in coin).
oi.by_exchange[].perpetual_usdnumberUSDContratti perpetui.
oi.by_exchange[].delivery_usdnumberUSDContratti a scadenza.
oi.by_exchange[].oi_sidestring—`double` quando l'exchange dichiara entrambi i lati in un unico numero, `single` quando ne dichiara uno solo, `unstated` quando l'exchange non lo documenta.
oi.by_exchange[].oi_usd_single_adjustednumber|nullUSDEquivalente unilaterale; null quando la convenzione sul lato non è dichiarata.
oi.by_exchange[].updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.
oi.by_exchange[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
oi.by_exchange[].is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
oi.contractsarray—Righe per contratto.
oi.contracts[]object—Righe per contratto.
oi.contracts[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
oi.contracts[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
oi.contracts[].native_symbolstring|null—Simbolo esattamente come lo scrive l'exchange.
oi.contracts[].oi_usdnumberUSDOpen interest in nozionale USD.
oi.contracts[].oi_sidestring—`double`, `single` o `unstated`: indica se l'exchange dichiara entrambi i lati dell'open interest in un unico numero.
oi.contracts[].oi_usd_singlenumber|nullUSDEquivalente unilaterale di `oi_usd`; null quando la convenzione sul lato non è dichiarata.
oi.contracts[].marginstring—Classe della valuta di margine: `usdt`, `usdc`, `coin` o `other`.
oi.contracts[].kindstring—`linear` o `inverse`.
oi.contracts[].contract_typestring—`perpetual` o `delivery`.
oi.contracts[].expiry_tsnumber|nullmsScadenza di un contratto a scadenza; null per i perpetui o quando non è pubblicata.
oi.contracts[].margin_basisstring—Come è stata determinata la classe di margine (dalla specifica del contratto o dal valore predefinito dell'exchange).
oi.contracts[].updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.
oi.contracts[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
oi.contracts[].is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
oi.contracts[].collectorstring—Collector interno che ha prodotto la riga.
oi.contracts[].included_sincenumber|nullmsMomento in cui questo contratto è entrato nei totali; null per l'insieme di base.
oi.coverageobject—Che cosa è incluso e che cosa non lo è nei numeri qui sopra. Va confrontato prima di confrontare i totali con un'altra fonte.
oi.coverage.included_exchangesarray—Exchange i cui dati sono inclusi nei totali.
oi.coverage.included_exchanges[]string—Exchange inclusi nei totali.
oi.coverage.pendingarray—Contratti raccolti ma non ancora inclusi nei totali (per esempio mentre il loro storico di 25 ore è ancora in costruzione). Sono elencati con il valore attuale, così che la lacuna sia visibile.
oi.coverage.pending[]object—Elementi raccolti ma non ancora inclusi.
oi.coverage.pending[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
oi.coverage.pending[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
oi.coverage.pending[].native_symbolstring—Simbolo esattamente come lo scrive l'exchange.
oi.coverage.pending[].marginstring—Classe della valuta di margine.
oi.coverage.pending[].contract_typestring—`perpetual` o `delivery`.
oi.coverage.pending[].oi_usdnumberUSDOpen interest in nozionale USD.
oi.coverage.pending[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
oi.coverage.pending[].reasonstring—Codice del motivo.
oi.coverage.pending[].detailstring|null—Dettaglio.
oi.coverage.pending_usdnumber|nullUSDSomma dei contratti in attesa, non compresa in `total_usd`.
oi.coverage.stale_excludedarray—Righe escluse perché il loro ultimo aggiornamento è fuori dalla finestra di utilizzabilità. vuoto nei campioni usati per generare questa tabella
oi.coverage.unavailablearray—Coppie exchange / contratto che non è stato possibile includere, ciascuna con un motivo. Non vengono mai conteggiate come 0.
oi.coverage.unavailable[]object—Elementi per i quali non sono disponibili dati, con i motivi. Mai riportati come 0.
oi.coverage.unavailable[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
oi.coverage.unavailable[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
oi.coverage.unavailable[].native_symbolstring—Simbolo esattamente come lo scrive l'exchange.
oi.coverage.unavailable[].marginstring—Classe della valuta di margine.
oi.coverage.unavailable[].contract_typestring—`perpetual` o `delivery`.
oi.coverage.unavailable[].reasonstring—Codice del motivo.
oi.coverage.unavailable[].detailstring—Dettaglio.
oi.methodobject—Enunciato in testo semplice delle formule usate per questa risposta.
oi.method.totalstring—Totale.
oi.method.usdstringUSDValore.
oi.method.change_h1_h4string—Definizione in testo semplice delle variazioni dell'open interest a 1h e a 4h: ogni contratto è confrontato con la propria istantanea più vicina all'inizio della finestra.
oi.method.change_h24string—Definizione in testo semplice della variazione dell'open interest a 24h: abbinamento sullo stesso exchange con l'istantanea oraria più vicina a 24 ore fa, escluse le basi di confronto congelate.
oi.method.oi_sidestring—`double`, `single` o `unstated`: indica se l'exchange dichiara entrambi i lati dell'open interest in un unico numero.
fundingobject—Lo stesso oggetto restituito da `/api/sd/funding` per questa moneta.
funding.coinstring—Simbolo della moneta, in maiuscolo (per esempio BTC).
funding.nownumbermsOra del server al momento della composizione della risposta.
funding.unitstring—Unità di tutti i campi di tasso in questa risposta: `fraction` (0.0001 = 0.01 %).
funding.avg_8hnumberfraction per 8hMedia semplice dei tassi normalizzati a 8h, un contratto per exchange.
funding.oi_weighted_8hnumberfraction per 8hMedia ponderata per open interest dei tassi normalizzati a 8h.
funding.apr_pctnumber% per yearAnnualizzazione semplice: tasso a 8h × 3 × 365 × 100.
funding.apr_basisstring—Aggregato su cui si basa il valore principale `apr_pct`.
funding.n_exchangesnumber—Numero di exchange che contribuiscono.
funding.n_normalizednumber—Exchange il cui intervallo di finanziamento è noto e ha potuto essere normalizzato a 8h.
funding.n_unknown_intervalnumber—Exchange esclusi dagli aggregati perché il loro intervallo di finanziamento è sconosciuto.
funding.settled_cum_7dobject—Somma dei tassi di finanziamento effettivamente regolati negli ultimi 7 giorni, mediata tra gli exchange con storico dei regolamenti.
funding.settled_cum_7d.avgnumberfractionMedia semplice tra gli exchange.
funding.settled_cum_7d.oi_weightednumberfractionMedia ponderata per open interest.
funding.settled_cum_7d.nnumber—Exchange con una finestra completa.
funding.settled_cum_30dobject—Lo stesso, su 30 giorni.
funding.settled_cum_30d.avgnumberfractionMedia semplice tra gli exchange.
funding.settled_cum_30d.oi_weightednumberfractionMedia ponderata per open interest.
funding.settled_cum_30d.nnumber—Exchange con una finestra completa.
funding.by_exchangearray—Una riga per exchange: il suo contratto principale per questa moneta (quello con l'open interest maggiore).
funding.by_exchange[]object—Ripartizione per exchange.
funding.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
funding.by_exchange[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
funding.by_exchange[].marginstring—Classe della valuta di margine.
funding.by_exchange[].kindstring—Tipo.
funding.by_exchange[].primaryboolean—True per il contratto che rappresenta il proprio exchange negli aggregati (quello con l'open interest più alto); sempre true in questo elenco.
funding.by_exchange[].ratenumber—Tasso.
funding.by_exchange[].interval_hnumberhIntervallo.
funding.by_exchange[].rate_8hnumber—Tasso normalizzato a un periodo di 8 ore.
funding.by_exchange[].apr_pctnumber% per yearPercentuale annualizzata.
funding.by_exchange[].next_funding_timenumber|nullmsTimestamp.
funding.by_exchange[].next_derivedboolean—True quando `next_funding_time` non è stato pubblicato dall'exchange ed è dedotto come la successiva ora intera UTC (solo per le piattaforme con regolamento orario).
funding.by_exchange[].predicted_ratenull—Tasso indicativo del periodo successivo; null quando non è pubblicato.
funding.by_exchange[].oi_usdnumber|nullUSDOpen interest in nozionale USD.
funding.by_exchange[].updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.
funding.by_exchange[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
funding.by_exchange[].is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
funding.by_exchange[].settledobject|null—Record di regolamento effettivi; null quando non esiste uno storico pubblico.
funding.by_exchange[].settled.last_ratenumberfractionTasso di finanziamento effettivamente applicato al regolamento più recente (`last_time`), dallo storico dei finanziamenti dell'exchange (0.0001 = 0.01 %). può essere assente
funding.by_exchange[].settled.last_timenumbermsTimestamp. può essere assente
funding.by_exchange[].settled.interval_hnumberhIntervallo. può essere assente
funding.by_exchange[].settled.cum_7dnumberfractionSomma dei tassi di finanziamento regolati su questo contratto negli ultimi 7 giorni (0.0015 = 0.15 %); null quando non è stato registrato alcun regolamento. può essere assente
funding.by_exchange[].settled.n_7dnumbercountNumero di record di regolamento raccolti per gli ultimi 7 giorni. può essere assente
funding.by_exchange[].settled.n_7d_expectednumbercountRegolamenti che una finestra completa di 7 giorni dovrebbe contenere: 168 ÷ intervallo di regolamento in ore; null quando l'intervallo è sconosciuto. può essere assente
funding.by_exchange[].settled.cum_7d_completeboolean—True quando lo storico copre l'inizio della finestra di 7 giorni e contiene almeno il 90 % dei regolamenti previsti. può essere assente
funding.by_exchange[].settled.cum_30dnumberfractionSomma dei tassi di finanziamento regolati su questo contratto negli ultimi 30 giorni (0.006 = 0.6 %). può essere assente
funding.by_exchange[].settled.n_30dnumbercountNumero di record di regolamento raccolti per gli ultimi 30 giorni. può essere assente
funding.by_exchange[].settled.n_30d_expectednumbercountRegolamenti che una finestra completa di 30 giorni dovrebbe contenere: 720 ÷ intervallo di regolamento in ore; null quando l'intervallo è sconosciuto. può essere assente
funding.by_exchange[].settled.cum_30d_completeboolean—True quando lo storico copre l'inizio della finestra di 30 giorni e contiene almeno il 90 % dei regolamenti previsti. può essere assente
funding.by_exchange[].settled.history_fromnumbermsRecord più vecchio conservato. può essere assente
funding.other_contractsarray—Ulteriori contratti della stessa moneta (USDC, con margine in coin, …). Non rientrano negli aggregati.
funding.other_contracts[]object—Un ulteriore contratto con finanziamento di un exchange (con margine in coin, USDC, …) che non è il suo contratto primario ed è escluso dagli aggregati.
funding.other_contracts[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
funding.other_contracts[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
funding.other_contracts[].marginstring—Classe della valuta di margine.
funding.other_contracts[].kindstring—Tipo.
funding.other_contracts[].primaryboolean—False per ogni riga di questo elenco: il contratto non è quello che rappresenta il proprio exchange negli aggregati.
funding.other_contracts[].ratenumber—Tasso.
funding.other_contracts[].interval_hnumber|nullhIntervallo.
funding.other_contracts[].rate_8hnumber|null—Tasso normalizzato a un periodo di 8 ore.
funding.other_contracts[].apr_pctnumber|null% per yearPercentuale annualizzata.
funding.other_contracts[].next_funding_timenumber|nullmsTimestamp.
funding.other_contracts[].next_derivedboolean—True quando `next_funding_time` non è stato pubblicato dall'exchange ed è dedotto come la successiva ora intera UTC (solo per le piattaforme con regolamento orario).
funding.other_contracts[].predicted_ratenumber|null—Tasso indicativo del periodo successivo; null quando non è pubblicato.
funding.other_contracts[].oi_usdnumber|nullUSDOpen interest in nozionale USD.
funding.other_contracts[].updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.
funding.other_contracts[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
funding.other_contracts[].is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
funding.other_contracts[].settledobject|null—Record di regolamento effettivi; null quando non esiste uno storico pubblico.
funding.other_contracts[].settled.last_ratenumberfractionTasso di finanziamento effettivamente applicato al regolamento più recente (`last_time`), dallo storico dei finanziamenti dell'exchange (0.0001 = 0.01 %). può essere assente
funding.other_contracts[].settled.last_timenumbermsTimestamp. può essere assente
funding.other_contracts[].settled.interval_hnumberhIntervallo. può essere assente
funding.other_contracts[].settled.cum_7dnumberfractionSomma dei tassi di finanziamento regolati su questo contratto negli ultimi 7 giorni (0.0015 = 0.15 %); null quando non è stato registrato alcun regolamento. può essere assente
funding.other_contracts[].settled.n_7dnumbercountNumero di record di regolamento raccolti per gli ultimi 7 giorni. può essere assente
funding.other_contracts[].settled.n_7d_expectednumbercountRegolamenti che una finestra completa di 7 giorni dovrebbe contenere: 168 ÷ intervallo di regolamento in ore; null quando l'intervallo è sconosciuto. può essere assente
funding.other_contracts[].settled.cum_7d_completeboolean—True quando lo storico copre l'inizio della finestra di 7 giorni e contiene almeno il 90 % dei regolamenti previsti. può essere assente
funding.other_contracts[].settled.cum_30dnumberfractionSomma dei tassi di finanziamento regolati su questo contratto negli ultimi 30 giorni (0.006 = 0.6 %). può essere assente
funding.other_contracts[].settled.n_30dnumbercountNumero di record di regolamento raccolti per gli ultimi 30 giorni. può essere assente
funding.other_contracts[].settled.n_30d_expectednumbercountRegolamenti che una finestra completa di 30 giorni dovrebbe contenere: 720 ÷ intervallo di regolamento in ore; null quando l'intervallo è sconosciuto. può essere assente
funding.other_contracts[].settled.cum_30d_completeboolean—True quando lo storico copre l'inizio della finestra di 30 giorni e contiene almeno il 90 % dei regolamenti previsti. può essere assente
funding.other_contracts[].settled.history_fromnumbermsRecord più vecchio conservato. può essere assente
funding.coverageobject—Che cosa è incluso e che cosa non lo è nei numeri qui sopra. Va confrontato prima di confrontare i totali con un'altra fonte.
funding.coverage.settle_history_exchangesarray—Exchange per i quali vengono raccolti i record di regolamento effettivi.
funding.coverage.settle_history_exchanges[]string—ID dell'exchange per il quale vengono raccolti i record effettivi di regolamento del finanziamento di questa moneta.
funding.coverage.no_settle_historyarray—Exchange privi di una fonte pubblica dello storico dei regolamenti; il loro `settled` è null.
funding.coverage.no_settle_history[]string—ID dell'exchange di un contratto primario privo di storico dei regolamenti raccolto, il cui blocco `settled` è quindi null.
funding.coverage.unknown_intervalarray—Righe il cui intervallo di finanziamento non ha potuto essere determinato. vuoto nei campioni usati per generare questa tabella
funding.coverage.no_liveness_excludedarray—Righe escluse perché il contratto non mostra segni di negoziazione (nessun ticker, open interest o quotazione recente). vuoto nei campioni usati per generare questa tabella
funding.methodobject—Enunciato in testo semplice delle formule usate per questa risposta.
funding.method.ratestring—Tasso.
funding.method.rate_8hstring—Tasso normalizzato a un periodo di 8 ore.
funding.method.apr_pctstring% per yearPercentuale annualizzata.
funding.method.aggregatestring—Aggregato tra gli exchange.
funding.method.settledstring—Record di regolamento effettivi; null quando non esiste uno storico pubblico.
funding.method.predicted_ratestring—Tasso indicativo del periodo successivo; null quando non è pubblicato.
funding.method.livenessstring—Regola in testo semplice per scartare i contratti morti: una riga di finanziamento conta solo con un ticker entro 1h, open interest entro 3h o una quotazione propria entro 3h.
liquidationsobject—Lo stesso oggetto restituito da `/api/sd/liquidations` per questa moneta.
liquidations.coinstring—Simbolo della moneta, in maiuscolo (per esempio BTC).
liquidations.nownumbermsOra del server al momento della composizione della risposta.
liquidations.windowsobject—Totali per ciascuna finestra (chiavi come `1h`, `4h`, `12h`, `24h`). chiavi dinamiche: 1h,4h,12h,24h
liquidations.windows.{*}object—Valori per finestra.
liquidations.windows.{*}.long_usdnumberUSDPosizioni long liquidate; null quando nessuna fonte ha coperto la finestra.
liquidations.windows.{*}.short_usdnumberUSDPosizioni short liquidate; null quando nessuna fonte ha coperto la finestra.
liquidations.windows.{*}.total_usdnumberUSDLong + short.
liquidations.windows.{*}.countnumber—Numero di ordini di liquidazione.
liquidations.windows.{*}.long_pctnumber%Quota dei long sul totale.
liquidations.windows.{*}.max_orderobject—Maggiore liquidazione singola nella finestra.
liquidations.windows.{*}.max_order.exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
liquidations.windows.{*}.max_order.symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
liquidations.windows.{*}.max_order.sidestring—`long` / `short` oppure `buy` / `sell`.
liquidations.windows.{*}.max_order.pricenumber—Ultimo prezzo nella valuta di quotazione (USD o USDT, salvo diversa indicazione).
liquidations.windows.{*}.max_order.qtynumber—Quantità.
liquidations.windows.{*}.max_order.contract_multipliernumberxMonete per unità di contratto quotata dell'ordine più grande (1000 per i contratti del tipo 1000PEPE); `price` e `qty` sono già convertiti in monete singole.
liquidations.windows.{*}.max_order.value_usdnumberUSDValore.
liquidations.windows.{*}.max_order.timestampnumbermsTimestamp.
liquidations.by_exchangeobject—Ripartizione per exchange per ciascuna finestra. chiavi dinamiche: 1h,4h,12h,24h
liquidations.by_exchange.{*}array—Ripartizione per exchange.
liquidations.by_exchange.{*}[]object—Ripartizione per exchange.
liquidations.by_exchange.{*}[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
liquidations.by_exchange.{*}[].long_usdnumberUSDLato long.
liquidations.by_exchange.{*}[].short_usdnumberUSDLato short.
liquidations.by_exchange.{*}[].total_usdnumberUSDTotale.
liquidations.by_exchange.{*}[].countnumber—Numero di elementi.
liquidations.by_exchange.{*}[].share_pctnumber%Quota sul totale.
liquidations.last_event_atnumbermsOra della liquidazione più recente per questa moneta.
liquidations.last_event_age_snumbersSecondi trascorsi da quell'evento.
liquidations.sourcesarray—Stato di ogni feed di liquidazioni: come viene raccolto e quando ha fornito dati l'ultima volta.
liquidations.sources[]object—Fonti dei dati.
liquidations.sources[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
liquidations.sources[].viastring—Metodo di raccolta (`ws`, `rest`, …).
liquidations.sources[].statusstring—Stato del feed, valutato dagli orari dei suoi eventi e dai suoi heartbeat.
liquidations.sources[].feed_last_event_age_snumber|nullsSecondi trascorsi dall'evento.
liquidations.sources[].ws_heartbeat_age_snumber|nullsSecondi trascorsi dall'evento.
liquidations.sources[].judged_bystring—Timestamp in base al quale è stato valutato lo stato.
liquidations.sources[].coin_last_event_age_snumber|nullsSecondi trascorsi dall'evento.
liquidations.sources[].min_event_usdnumberUSDDimensione minima dell'ordine pubblicata dal feed; le liquidazioni più piccole non sono visibili su questo exchange.
liquidations.sources[].notestring|null—Nota.
liquidations.sources[].node_heartbeat_age_snumbersSecondi trascorsi dall'evento. può essere assente
liquidations.sources[].pipeline_last_event_age_snumbersSecondi trascorsi dall'evento. può essere assente
liquidations.coverageobject—Che cosa è incluso e che cosa non lo è nei numeri qui sopra. Va confrontato prima di confrontare i totali con un'altra fonte.
liquidations.coverage.collected_exchangesarray—Exchange con un feed pubblico di liquidazioni raccolto da CoinBoss.
liquidations.coverage.collected_exchanges[]string—Exchange raccolti.
liquidations.coverage.unavailablearray—Coppie exchange / contratto che non è stato possibile includere, ciascuna con un motivo. Non vengono mai conteggiate come 0.
liquidations.coverage.unavailable[]object—Elementi per i quali non sono disponibili dati, con i motivi. Mai riportati come 0.
liquidations.coverage.unavailable[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
liquidations.coverage.unavailable[].reasonstring—Codice del motivo.
liquidations.methodobject—Enunciato in testo semplice delle formule usate per questa risposta.
liquidations.method.eventstring—Nota in testo semplice su che cosa sia un evento di liquidazione: un ordine di liquidazione inviato dal flusso dell'exchange o restituito dalla sua API REST pubblica.
liquidations.method.sidestring—`long` / `short` oppure `buy` / `sell`.
liquidations.method.value_usdstringUSDValore.
liquidations.method.dedupestring—Nota in testo semplice sulla deduplicazione: gli eventi sono univoci per exchange, simbolo, lato, prezzo, valore e timestamp, più l'ID dell'ordine dell'exchange dove è fornito.
liquidations.method.null_rulestring—Nota in testo semplice: una finestra senza alcun evento raccolto restituisce null anziché 0; indica inoltre dove sono elencati gli exchange privi di un feed pubblico.
liquidations.method.binance_notestring—Avvertenza in testo semplice: Binance invia al massimo una liquidazione per simbolo al secondo, quindi i totali di Binance sono un limite inferiore.
liquidations.method.min_event_usdstringUSDOrdine più piccolo pubblicato dal feed.
volumeobject—Lo stesso oggetto restituito da `/api/sd/volume` per questa moneta.
volume.coinstring—Simbolo della moneta, in maiuscolo (per esempio BTC).
volume.nownumbermsOra del server al momento della composizione della risposta.
volume.futuresobject—Blocco o valore del mercato futures.
volume.futures.total_usdnumberUSDVolume futures a 24h tra gli exchange (nozionale USD).
volume.futures.n_exchangesnumber—Numero di exchange che contribuiscono.
volume.futures.by_exchangearray—Ripartizione per exchange.
volume.futures.by_exchange[]object—Ripartizione per exchange.
volume.futures.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
volume.futures.by_exchange[].vol_usdnumberUSDVolume in nozionale USD.
volume.futures.by_exchange[].legacy_usdnumberUSDParte del volume che proviene dall'insieme dei ticker dei perpetui USDT.
volume.futures.by_exchange[].sd_usdnumberUSDParte che proviene dai contratti aggiuntivi (USDC, con margine in coin, a scadenza) già inclusi.
volume.futures.by_exchange[].share_pctnumber%Quota sul totale.
volume.futures.change_24hobject—Variazione a 24h.
volume.futures.change_24h.pctnumber%Percentuale.
volume.futures.change_24h.curnumber—Valore attuale.
volume.futures.change_24h.prevnumber—Valore precedente (base di confronto).
volume.futures.change_24h.n_matchednumber—Elementi presenti a entrambi gli estremi del confronto.
volume.futures.change_24h.n_totalnumber—Elementi presenti ora.
volume.futures.change_24h.prev_tsnumbermsOra dell'istantanea di confronto.
volume.futures.change_24h.basisstring—Prezzo futures meno prezzo spot, oppure il blocco della base.
volume.futures.selfdata_contractsobject—Contratti aggiuntivi: che cosa è già incluso e che cosa è ancora in attesa.
volume.futures.selfdata_contracts.included_usdnullUSDVolume a 24h dei contratti raccolti in aggiunta (con margine in coin, USDC, a scadenza) già conteggiati nel totale futures; null quando nessuno è ancora conteggiato.
volume.futures.selfdata_contracts.n_includednumbercountNumero di contratti raccolti in aggiunta conteggiati nel totale futures (quelli che dispongono di una propria istantanea di circa 24 ore fa).
volume.futures.selfdata_contracts.pending_usdnumber|nullUSDSomma degli elementi in attesa, non compresa nel totale.
volume.futures.selfdata_contracts.n_pendingnumbercountNumero di contratti raccolti in aggiunta non ancora conteggiati perché privi di una propria base di confronto di 24 ore fa; i maggiori sono elencati in `pending`.
volume.futures.selfdata_contracts.pendingarray—Elementi raccolti ma non ancora inclusi.
volume.futures.selfdata_contracts.pending[]object—Elementi raccolti ma non ancora inclusi.
volume.futures.selfdata_contracts.pending[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
volume.futures.selfdata_contracts.pending[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
volume.futures.selfdata_contracts.pending[].marginstring—Classe della valuta di margine.
volume.futures.selfdata_contracts.pending[].contract_typestring—`perpetual` o `delivery`.
volume.futures.selfdata_contracts.pending[].vol_usdnumberUSDVolume in nozionale USD.
volume.futures.selfdata_contracts.pending[].reasonstring—Codice del motivo.
volume.spotobject—Blocco o valore del mercato spot.
volume.spot.total_usdnumberUSDVolume spot a 24h tra gli exchange.
volume.spot.n_exchangesnumber—Numero di exchange che contribuiscono.
volume.spot.asofnumbermsOra del dato più recente utilizzato.
volume.spot.by_exchangearray—Ripartizione per exchange.
volume.spot.by_exchange[]object—Ripartizione per exchange.
volume.spot.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
volume.spot.by_exchange[].vol_usdnumberUSDVolume in nozionale USD.
volume.spot.by_exchange[].quotestring—Valute di quotazione incluse per questo exchange.
volume.spot.by_exchange[].tsnumbermsTimestamp.
volume.spot.by_exchange[].pricenumber—Ultimo prezzo nella valuta di quotazione (USD o USDT, salvo diversa indicazione).
volume.spot.by_exchange[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
volume.spot.by_exchange[].share_pctnumber%Quota sul totale.
volume.spot.change_24hobject—Variazione a 24h.
volume.spot.change_24h.pctnumber%Percentuale.
volume.spot.change_24h.curnumber—Valore attuale.
volume.spot.change_24h.prevnumber—Valore precedente (base di confronto).
volume.spot.change_24h.n_matchednumber—Elementi presenti a entrambi gli estremi del confronto.
volume.spot.change_24h.n_totalnumber—Elementi presenti ora.
volume.spot.change_24h.prev_tsnumbermsOra dell'istantanea di confronto.
volume.spot.change_24h.basisstring—Prezzo futures meno prezzo spot, oppure il blocco della base.
volume.ratiosobject—Rapporti di volume: `futures_to_spot` (volume futures a 24h ÷ volume spot a 24h) e `oi_to_futures_volume`; ciascuno è null quando manca un dato di ingresso.
volume.ratios.futures_to_spotnumber—Volume futures diviso per il volume spot.
volume.ratios.oi_to_futures_volumenumber—Open interest diviso per il volume futures a 24h.
volume.methodobject—Enunciato in testo semplice delle formule usate per questa risposta.
volume.method.futuresstring—Blocco o valore del mercato futures.
volume.method.spotstring—Blocco o valore del mercato spot.
volume.method.changestring—Variazione nel periodo indicato.
volume.method.oi_to_futures_volumestring—Definizione in testo semplice di `ratios.oi_to_futures_volume`: open interest totale in USD ÷ volume futures a 24h in USD.
lsobject—Lo stesso oggetto restituito da `/api/sd/ls` per questa moneta.
ls.coinstring—Simbolo della moneta, in maiuscolo (per esempio BTC).
ls.nownumbermsOra del server al momento della composizione della risposta.
ls.accountobject—Quota di tutti gli account che sono netti long rispetto a quelli netti short.
ls.account.long_pctnumber%Quota long.
ls.account.short_pctnumber%Quota short.
ls.account.rationumber—Rapporto.
ls.account.n_exchangesnumber—Numero di exchange che contribuiscono.
ls.account.by_exchangearray—Ripartizione per exchange.
ls.account.by_exchange[]object—Ripartizione per exchange.
ls.account.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
ls.account.by_exchange[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
ls.account.by_exchange[].long_pctnumber%Quota long.
ls.account.by_exchange[].short_pctnumber%Quota short.
ls.account.by_exchange[].rationumber—Rapporto.
ls.account.by_exchange[].updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.
ls.account.by_exchange[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
ls.account.by_exchange[].is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
ls.account.by_exchange[].sourcestring—Provenienza del valore.
ls.account.by_exchange[].periodstring—Periodo.
ls.top_accountobject—Lo stesso, limitato ai top trader definiti dall'exchange.
ls.top_account.long_pctnumber|null%Quota long.
ls.top_account.short_pctnumber|null%Quota short.
ls.top_account.rationumber|null—Rapporto.
ls.top_account.n_exchangesnumber—Numero di exchange che contribuiscono.
ls.top_account.by_exchangearray—Ripartizione per exchange.
ls.top_account.by_exchange[]object—Ripartizione per exchange.
ls.top_account.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
ls.top_account.by_exchange[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
ls.top_account.by_exchange[].long_pctnumber%Quota long.
ls.top_account.by_exchange[].short_pctnumber%Quota short.
ls.top_account.by_exchange[].rationumber—Rapporto.
ls.top_account.by_exchange[].updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.
ls.top_account.by_exchange[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
ls.top_account.by_exchange[].is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
ls.top_account.by_exchange[].sourcestring—Provenienza del valore.
ls.top_account.by_exchange[].periodstring—Periodo.
ls.top_positionobject—Quota long rispetto a quella short delle posizioni detenute dai top trader.
ls.top_position.long_pctnumber|null%Quota long.
ls.top_position.short_pctnumber|null%Quota short.
ls.top_position.rationumber|null—Rapporto.
ls.top_position.n_exchangesnumber—Numero di exchange che contribuiscono.
ls.top_position.by_exchangearray—Ripartizione per exchange.
ls.top_position.by_exchange[]object—Ripartizione per exchange.
ls.top_position.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
ls.top_position.by_exchange[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
ls.top_position.by_exchange[].long_pctnumber%Quota long.
ls.top_position.by_exchange[].short_pctnumber%Quota short.
ls.top_position.by_exchange[].rationumber—Rapporto.
ls.top_position.by_exchange[].updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.
ls.top_position.by_exchange[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
ls.top_position.by_exchange[].is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
ls.top_position.by_exchange[].sourcestring—Provenienza del valore.
ls.top_position.by_exchange[].periodstring—Periodo.
ls.position_allobject—Quota long rispetto a quella short di tutte le posizioni (exchange che la pubblicano).
ls.position_all.long_pctnumber|null%Quota long.
ls.position_all.short_pctnumber|null%Quota short.
ls.position_all.rationumber|null—Rapporto.
ls.position_all.n_exchangesnumber—Numero di exchange che contribuiscono.
ls.position_all.by_exchangearray—Ripartizione per exchange.
ls.position_all.by_exchange[]object—Ripartizione per exchange.
ls.position_all.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
ls.position_all.by_exchange[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
ls.position_all.by_exchange[].long_pctnumber%Quota long.
ls.position_all.by_exchange[].short_pctnumber%Quota short.
ls.position_all.by_exchange[].rationumber—Rapporto.
ls.position_all.by_exchange[].updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.
ls.position_all.by_exchange[].age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
ls.position_all.by_exchange[].is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
ls.position_all.by_exchange[].sourcestring—Provenienza del valore.
ls.position_all.by_exchange[].periodstring—Periodo.
ls.takerobject—Quota del volume di acquisto taker rispetto a quello di vendita taker.
ls.taker.long_pctnumber|null%Quota long.
ls.taker.short_pctnumber|null%Quota short.
ls.taker.rationumber|null—Rapporto.
ls.taker.n_exchangesnumber—Numero di exchange che contribuiscono.
ls.taker.by_exchangearray—Ripartizione per exchange.
ls.definitionsobject—Definizione di ciascuna misura. Le cinque misure rispondono a domande diverse e non vengono mai combinate. può essere assente
ls.definitions.accountstring—Misura basata sugli account. può essere assente
ls.definitions.top_accountstring—Misura per account dei top trader. può essere assente
ls.definitions.top_positionstring—Misura per posizioni dei top trader. può essere assente
ls.definitions.position_allstring—Misura su tutte le posizioni. può essere assente
ls.definitions.takerstring—Misura acquisti / vendite taker. può essere assente
ls.methodobject—Enunciato in testo semplice delle formule usate per questa risposta. può essere assente
ls.method.normalizestring—Nota in testo semplice sulla normalizzazione: il valore di ogni exchange è riscalato in modo che long % + short % = 100, e rapporto = long % ÷ short %. può essere assente
ls.method.aggregatestring—Aggregato tra gli exchange. può essere assente
ls.method.freshnessstring—Regola di freschezza in testo semplice: sono mostrate le righe aggiornate nelle ultime 24 ore e `is_stale` contrassegna le righe più vecchie di 2 ore. può essere assente
errorsobject—Parti del pacchetto la cui costruzione non è riuscita, indicizzate per nome della parte; vuoto quando tutte le parti sono presenti. può essere assente

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

Risposta di esempio

Nessun esempio in archivio: l'ultima risposta riuscita era troppo grande per essere visualizzata. Chiamare l'endpoint nel Playground.

Campioni verificati

Oltre all'esempio qui sopra, la sonda chiama questo endpoint con i parametri seguenti e ogni volta ne verifica lo schema.

ParametriHTTPLatenzaRisultato
coin=ETH20073 msSuperato
coin=SOL20059 msSuperato
coin=ARKM20059 msSuperato
—4002 msSuperato restituisce l'errore previsto

Verificato 2026-11-13 03:57:35 UTC

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
15s
Micro-cache edge
10s
Frequenza di aggiornamento
vedere /api/sd/oi, /api/sd/funding, /api/sd/liquidations, /api/sd/volume, /api/sd/ls (polling da 60 s a 5 min; liquidazioni in tempo reale; spot ogni 10 min)
Finestra
ultima istantanea per blocco, più le finestre mobili proprie di ciascun blocco
Fonti dei dati
Blocchi combinati di open interest, finanziamento, liquidazioni, volume e long/short di una moneta, tutti costruiti dai collector di CoinBoss che interrogano le API pubbliche di circa 30 exchange (ad es. binance, okx, bybit, bitget, gate, hyperliquid).
Copertura degli exchange
come per i cinque endpoint a blocco singolo; l'elenco dei contratti è troncato a 60 righe
Unità
USD notional for OI / volume / liquidations; funding as fraction; long/short in percent
Metodo
same builders as the five single-block endpoints
Timestamp
Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
Formato della risposta
json
Stabilità
Stabile
Disponibile dal
2026-11-11

Stato in tempo reale

DisponibileVerificato 2026-11-13 03:57:35 UTCHTTP 200875 msSchema conformeDato più recente risalente a 0s fa

Disponibilità, ultimi 30 giorni

100% di 411 verifiche superate

Deriva dello schema rilevata dall'ultima verifica della sonda
  • Restituito ma non documentato: oi.coverage.stale_excluded[], oi.coverage.stale_excluded[].exchange, oi.coverage.stale_excluded[].symbol, oi.coverage.stale_excluded[].oi_usd, oi.coverage.stale_excluded[].age_s, oi.coverage.stale_excluded[].reason, ls.taker.by_exchange[], ls.taker.by_exchange[].exchange, ls.taker.by_exchange[].symbol, ls.taker.by_exchange[].long_pct

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/sd/coinDisponibile
Parametri

string — Coin symbol; 400 when missing. Alias: `base`.

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