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

Base dei futures (tutti gli exchange)

Base dei contratti perpetui (mark rispetto a indice), base perpetuo-spot sullo stesso exchange e base dei futures a scadenza con tasso annualizzato, per contratto, più aggregati ponderati per OI, ponderati per volume e mediani.

GET/api/sd/basis
Degradato. L'endpoint segnala una qualità dei dati STALE

Richiesta

Parametri di query

NomeTipoObbligatorioPredefinitoValori ammessiDescrizione
coinstringObbligatorio——Simbolo della moneta, senza distinzione tra maiuscole e minuscole (per esempio `BTC`). I valori mancanti o malformati restituiscono 400. Esempio: BTC

Richiesta di esempio

curl -s "https://www.coinboss.com/api/sd/basis?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 }`.
schemastring—ID dello schema di questa risposta. Cambia solo quando un campo esistente cambia significato o tipo.
nownumbermsOra del server al momento della composizione della risposta.
coinstring—Simbolo della moneta (in maiuscolo).
perpobject—Base dei perpetui: prezzo mark rispetto al prezzo dell'indice dello stesso exchange.
perp.unitstring—Unità dei valori della base (percentuale).
perp.aggregateobject—Aggregato tra exchange della sezione.
perp.aggregate.oi_weighted_pctnumber%Base ponderata per open interest; le righe senza un peso OI sono escluse.
perp.aggregate.oi_weight_usdnumberUSDSomma dei pesi di open interest usati.
perp.aggregate.n_oi_weightednumber—Righe che avevano un peso OI.
perp.aggregate.vol_weighted_pctnumber%Base ponderata per volume nozionale a 24h.
perp.aggregate.vol_weight_usdnumberUSDSomma dei pesi di volume usati.
perp.aggregate.n_vol_weightednumber—Righe che avevano un peso di volume.
perp.aggregate.median_pctnumber%Mediana della base su un contratto principale per exchange.
perp.aggregate.mean_pctnumber%Media semplice sullo stesso insieme della mediana.
perp.aggregate.n_exchangesnumber—Exchange inclusi nell'aggregato.
perp.aggregate.n_contractsnumber—Contratti inclusi nell'aggregato.
perp.aggregate.minobject—Exchange e contratto con la base più bassa.
perp.aggregate.min.exchangestring—ID dell'exchange (in minuscolo).
perp.aggregate.min.symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
perp.aggregate.min.basis_pctnumber%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
perp.aggregate.maxobject—Exchange e contratto con la base più alta.
perp.aggregate.max.exchangestring—ID dell'exchange (in minuscolo).
perp.aggregate.max.symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
perp.aggregate.max.basis_pctnumber%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
perp.aggregate.median_last_pctnumber%Mediana della base sull'ultimo prezzo.
perp.aggregate.n_exchanges_lastnumber—Exchange inclusi nella mediana sull'ultimo prezzo.
perp.aggregate.weightsobject—Provenienza dei pesi, relativa finestra di freschezza ed età del peso più vecchio.
perp.aggregate.weights.oiobject—Open interest.
perp.aggregate.weights.oi.sourcestring—Endpoint pubblici a monte da cui sono stati raccolti i dati.
perp.aggregate.weights.oi.fresh_window_snumbersUn peso più vecchio di questo valore non viene usato.
perp.aggregate.weights.oi.oldest_age_snumbersEtà del peso più vecchio usato.
perp.aggregate.weights.oi.sidestring—Indica se il peso di open interest è unilaterale.
perp.aggregate.weights.volobject—Volume.
perp.aggregate.weights.vol.sourcestring—Endpoint pubblici a monte da cui sono stati raccolti i dati.
perp.aggregate.weights.vol.fresh_window_snumbersUn peso più vecchio di questo valore non viene usato.
perp.aggregate.weights.vol.oldest_age_snumbersEtà del peso più vecchio usato.
perp.contractsarray—Una riga per contratto.
perp.contracts[]object—Una riga per contratto.
perp.contracts[].exchangestring—ID dell'exchange (in minuscolo).
perp.contracts[].symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
perp.contracts[].native_symbolstring—Simbolo del contratto così come lo scrive l'exchange.
perp.contracts[].quotestring—Valuta di quotazione del contratto.
perp.contracts[].margin_typestring—Tipo di margine del contratto (per esempio con margine in USDT, con margine in coin).
perp.contracts[].multipliernumber—Monete per unità quotata (1000 per i contratti del tipo `1000PEPE`). La base non ne è influenzata.
perp.contracts[].mark_pricenumber|null—Prezzo mark pubblicato dall'exchange.
perp.contracts[].index_pricenumber|null—Prezzo dell'indice pubblicato dall'exchange.
perp.contracts[].last_pricenumber|null—Ultimo prezzo scambiato.
perp.contracts[].index_kindstring|null—Natura dell'indice: `exchange_index`, `oracle` o un altro tipo che viene mostrato ma non aggregato.
perp.contracts[].basis_pctnumber|null%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
perp.contracts[].basis_absnumber|null—mark − index, nella valuta di quotazione.
perp.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100; `null` quando non c'è uno scambio recente.
perp.contracts[].basis_last_reasonstring|null—Motivo per cui `basis_last_pct` è null.
perp.contracts[].index_lag_snumber|nullsSecondi tra il timestamp del prezzo mark e il timestamp dell'indice della riga.
perp.contracts[].oi_usdnumber|nullUSDOpen interest del contratto, unilaterale; usato come peso.
perp.contracts[].vol_usd_24hnumber|nullUSDVolume nozionale a 24h del contratto; usato come peso.
perp.contracts[].primaryboolean—True per il contratto che rappresenta il proprio exchange nella mediana e nella media.
perp.contracts[].in_aggregateboolean—True quando la riga ha superato le regole di inclusione.
perp.contracts[].excluded_reasonstring|null—Motivo per cui la riga non è nell'aggregato.
perp.contracts[].last_tsnumber|nullmsOra dell'ultimo scambio.
perp.contracts[].observed_atnumber|nullmsTimestamp indicato dalla fonte per i dati.
perp.contracts[].received_atnumbermsOra in cui il collector di CoinBoss ha ricevuto i dati.
perp.contracts[].age_snumbersSecondi trascorsi dalla ricezione della riga.
spot_perpobject—Prezzo del perpetuo rispetto al prezzo spot dello stesso exchange.
spot_perp.unitstring—Unità dei valori della base (percentuale).
spot_perp.aggregateobject—Aggregato tra exchange della sezione.
spot_perp.aggregate.oi_weighted_pctnumber%Base ponderata per open interest; le righe senza un peso OI sono escluse.
spot_perp.aggregate.oi_weight_usdnumberUSDSomma dei pesi di open interest usati.
spot_perp.aggregate.n_oi_weightednumber—Righe che avevano un peso OI.
spot_perp.aggregate.vol_weighted_pctnumber%Base ponderata per volume nozionale a 24h.
spot_perp.aggregate.vol_weight_usdnumberUSDSomma dei pesi di volume usati.
spot_perp.aggregate.n_vol_weightednumber—Righe che avevano un peso di volume.
spot_perp.aggregate.median_pctnumber%Mediana della base su un contratto principale per exchange.
spot_perp.aggregate.mean_pctnumber%Media semplice sullo stesso insieme della mediana.
spot_perp.aggregate.n_exchangesnumber—Exchange inclusi nell'aggregato.
spot_perp.aggregate.n_contractsnumber—Contratti inclusi nell'aggregato.
spot_perp.aggregate.minobject—Exchange e contratto con la base più bassa.
spot_perp.aggregate.min.exchangestring—ID dell'exchange (in minuscolo).
spot_perp.aggregate.min.symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
spot_perp.aggregate.min.basis_pctnumber%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
spot_perp.aggregate.maxobject—Exchange e contratto con la base più alta.
spot_perp.aggregate.max.exchangestring—ID dell'exchange (in minuscolo).
spot_perp.aggregate.max.symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
spot_perp.aggregate.max.basis_pctnumber%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
spot_perp.pairsarray—Una riga per coppia perpetuo / spot dello stesso exchange.
spot_perp.pairs[]object—Una riga per coppia perpetuo / spot dello stesso exchange.
spot_perp.pairs[].exchangestring—ID dell'exchange (in minuscolo).
spot_perp.pairs[].symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
spot_perp.pairs[].spot_symbolstring—Mercato spot usato come gamba spot.
spot_perp.pairs[].quotestring—Valuta di quotazione del contratto.
spot_perp.pairs[].spot_multnumber—Fattore applicato al prezzo spot affinché entrambe le gambe quotino la stessa quantità.
spot_perp.pairs[].futures_pricenumber|null—Prezzo del perpetuo usato; vedere `price_kind`.
spot_perp.pairs[].price_kindstring|null—Prezzo del perpetuo usato: `last` o `mark`.
spot_perp.pairs[].spot_pricenumber—Ultimo prezzo spot, dopo `spot_mult`.
spot_perp.pairs[].basis_pctnumber|null%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
spot_perp.pairs[].basis_last_pctnumber|null%(last − index) ÷ index × 100; `null` quando non c'è uno scambio recente.
spot_perp.pairs[].basis_mark_pctnumber|null%(mark − spot) ÷ spot × 100.
spot_perp.pairs[].leg_gap_snumbersSecondi tra i timestamp delle due gambe.
spot_perp.pairs[].spot_time_kindstring—Natura del timestamp spot (ora dello scambio o ora di ricezione).
spot_perp.pairs[].spot_vol_24hnumber|null—Controvalore scambiato a 24h del mercato spot, nella sua valuta di quotazione.
spot_perp.pairs[].oi_usdnumber|nullUSDOpen interest del contratto, unilaterale; usato come peso.
spot_perp.pairs[].vol_usd_24hnumber|nullUSDVolume nozionale a 24h del contratto; usato come peso.
spot_perp.pairs[].primaryboolean—True per il contratto che rappresenta il proprio exchange nella mediana e nella media.
spot_perp.pairs[].in_aggregateboolean—True quando la riga ha superato le regole di inclusione.
spot_perp.pairs[].excluded_reasonstring|null—Motivo per cui la riga non è nell'aggregato.
spot_perp.pairs[].received_atnumbermsOra in cui il collector di CoinBoss ha ricevuto i dati.
spot_perp.pairs[].spot_received_atnumbermsOra di ricezione della gamba spot.
deliveryobject—Base dei futures a scadenza (delivery).
delivery.unitstring—Unità dei valori della base (percentuale).
delivery.contractsarray—Una riga per contratto.
delivery.contracts[]object—Una riga per contratto.
delivery.contracts[].exchangestring—ID dell'exchange (in minuscolo).
delivery.contracts[].symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
delivery.contracts[].native_symbolstring—Simbolo del contratto così come lo scrive l'exchange.
delivery.contracts[].quotestring—Valuta di quotazione del contratto.
delivery.contracts[].margin_typestring—Tipo di margine del contratto (per esempio con margine in USDT, con margine in coin).
delivery.contracts[].expiry_tsnumbermsOra di scadenza del contratto a scadenza.
delivery.contracts[].days_to_expirynumberdaysGiorni alla scadenza.
delivery.contracts[].mark_pricenumber—Prezzo mark pubblicato dall'exchange.
delivery.contracts[].last_pricenumber|null—Ultimo prezzo scambiato.
delivery.contracts[].index_pricenumber—Prezzo dell'indice pubblicato dall'exchange.
delivery.contracts[].index_kindstring—Natura dell'indice: `exchange_index`, `oracle` o un altro tipo che viene mostrato ma non aggregato.
delivery.contracts[].basis_pctnumber%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
delivery.contracts[].annualized_pctnumber|null% per yearbasis_pct × 365 ÷ giorni alla scadenza, interesse semplice; `null` nell'ultimo giorno.
delivery.contracts[].basis_reasonnull—Motivo per cui `basis_pct` è null.
delivery.contracts[].index_lag_snumbersSecondi tra il timestamp del prezzo mark e il timestamp dell'indice della riga.
delivery.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100; `null` quando non c'è uno scambio recente.
delivery.contracts[].annualized_last_pctnumber|null% per yearBase annualizzata calcolata sull'ultimo prezzo scambiato.
delivery.contracts[].spot_symbolstring|null—Mercato spot usato come gamba spot.
delivery.contracts[].spot_pricenumber|null—Ultimo prezzo spot, dopo `spot_mult`.
delivery.contracts[].spot_price_kindstring|null—Prezzo futures confrontato con lo spot.
delivery.contracts[].basis_spot_pctnumber|null%(futures − spot dello stesso exchange) ÷ spot × 100.
delivery.contracts[].annualized_spot_pctnumber|null% per yearBase annualizzata rispetto allo spot dello stesso exchange.
delivery.contracts[].annualized_reasonstring|null—Motivo per cui il valore annualizzato è null (per esempio `expiry_lt_1d`).
delivery.contracts[].oi_usdnumber|nullUSDOpen interest del contratto, unilaterale; usato come peso.
delivery.contracts[].vol_usd_24hnumber|nullUSDVolume nozionale a 24h del contratto; usato come peso.
delivery.contracts[].last_tsnumber|nullmsOra dell'ultimo scambio.
delivery.contracts[].observed_atnumber|nullmsTimestamp indicato dalla fonte per i dati.
delivery.contracts[].received_atnumbermsOra in cui il collector di CoinBoss ha ricevuto i dati.
delivery.contracts[].age_snumbersSecondi trascorsi dalla ricezione della riga.
coverageobject—Che cosa è incluso e che cosa non è incluso nei numeri. Confrontare questo dato prima di confrontare i totali con un'altra fonte.
coverage.included_exchangesarray—Fonti i cui dati aggiornati sono inclusi.
coverage.included_exchanges[]string—Fonti i cui dati aggiornati sono inclusi.
coverage.unavailablearray—Fonti che non è stato possibile includere, ciascuna con il motivo. Non vengono mai conteggiate come 0.
coverage.unavailable[]object—Fonti che non è stato possibile includere, ciascuna con il motivo. Non vengono mai conteggiate come 0.
coverage.unavailable[].exchangestring—ID dell'exchange (in minuscolo).
coverage.unavailable[].reasonstring—Codice del motivo leggibile dalla macchina.
coverage.unavailable[].detailstring—Spiegazione del motivo in linguaggio naturale.
coverage.stale_excludedarray—Righe escluse perché il loro ultimo aggiornamento è fuori dalla finestra di freschezza. vuoto nei campioni usati per generare questa tabella
coverage.missing_fieldsarray—Exchange che non pubblicano uno dei prezzi.
coverage.excluded_from_aggregatearray—Righe mostrate ma escluse dall'aggregato, ciascuna con il motivo.
coverage.excluded_from_aggregate[]object—Righe mostrate ma escluse dall'aggregato, ciascuna con il motivo.
coverage.excluded_from_aggregate[].exchangestring—ID dell'exchange (in minuscolo).
coverage.excluded_from_aggregate[].symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
coverage.excluded_from_aggregate[].sectionstring—Sezione a cui appartiene la riga.
coverage.excluded_from_aggregate[].reasonstring—Codice del motivo leggibile dalla macchina.
coverage.stock_excludedarray—Perpetui su azioni che condividono il ticker e sono stati rimossi. vuoto nei campioni usati per generare questa tabella
coverage.dropped_delisted_rowsnumber—Righe scartate perché il contratto ha smesso di aggiornarsi.
coverage.delivery_unavailablearray—Exchange i cui contratti a scadenza non vengono raccolti.
coverage.delivery_unavailable[]object—Exchange i cui contratti a scadenza non vengono raccolti.
coverage.delivery_unavailable[].exchangestring—ID dell'exchange (in minuscolo).
coverage.delivery_unavailable[].reasonstring—Codice del motivo leggibile dalla macchina.
coverage.delivery_unavailable[].detailstring—Spiegazione del motivo in linguaggio naturale.
methodobject—Enunciato in testo semplice delle formule usate per questa risposta, una voce per campo.
method.perp.basis_pctstring—Nota sulla formula di `perp.basis_pct`, in testo semplice.
method.perp.basis_last_pctstring—Nota sulla formula di `perp.basis_last_pct`, in testo semplice.
method.perp.aggregate.oi_weighted_pctstring—Nota sulla formula di `perp.aggregate.oi_weighted_pct`, in testo semplice.
method.perp.aggregate.vol_weighted_pctstring—Nota sulla formula di `perp.aggregate.vol_weighted_pct`, in testo semplice.
method.perp.aggregate.median_pctstring—Nota sulla formula di `perp.aggregate.median_pct`, in testo semplice.
method.perp.aggregate.inclusionstring—Nota sulla formula di `perp.aggregate.inclusion`, in testo semplice.
method.spot_perp.basis_pctstring—Nota sulla formula di `spot_perp.basis_pct`, in testo semplice.
method.spot_perp.aggregate.inclusionstring—Nota sulla formula di `spot_perp.aggregate.inclusion`, in testo semplice.
method.delivery.basis_pctstring—Nota sulla formula di `delivery.basis_pct`, in testo semplice.
method.delivery.annualized_pctstring—Nota sulla formula di `delivery.annualized_pct`, in testo semplice.
method.index_lag_sstring—Nota sulla formula di `index_lag_s`, in testo semplice.
method.multiplierstring—Nota sulla formula di `multiplier`, in testo semplice.
metaobject—Provenienza e freschezza di questa risposta.
meta.schemastring—ID dello schema di questa risposta. Cambia solo quando un campo esistente cambia significato o tipo.
meta.sourcearray—Endpoint pubblici a monte da cui sono stati raccolti i dati.
meta.source[]object—Endpoint pubblici a monte da cui sono stati raccolti i dati.
meta.source[].exchangestring—ID dell'exchange (in minuscolo).
meta.source[].endpointstring—Endpoint pubblico della fonte letto dal collector (mostrato a scopo di provenienza; i client non lo chiamano mai).
meta.observed_atnumbermsTimestamp indicato dalla fonte per i dati.
meta.received_atnumbermsOra in cui il collector di CoinBoss ha ricevuto i dati.
meta.fetched_atnumbermsOra in cui questa risposta è stata composta.
meta.windowstring—Finestra temporale coperta dai numeri.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN o UNAVAILABLE, valutato dai timestamp dei dati e dalla copertura.
meta.is_staleboolean—True quando i dati sono più vecchi della loro finestra di freschezza.
meta.cache_ttl_snumbersDurata in cache di questa risposta.
meta.fallbackstring—Che cosa restituisce l'endpoint quando il collector o una fonte non funziona.
meta.collector_heartbeat_age_snumbersSecondi trascorsi dall'ultima volta in cui il collector ha segnalato di essere in esecuzione.
coverage.missing_fields[]object—Exchange che non pubblicano uno dei prezzi.
coverage.missing_fields[].exchangestring—ID dell'exchange (in minuscolo).
coverage.missing_fields[].symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
coverage.missing_fields[].missingstring—Prezzo che l'exchange non pubblica (`mark` o `index`).

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

Risposta di esempio

/api/sd/basis?coin=BTC · Risposta reale acquisita 2026-11-13 03:52:48 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: meta.source conteneva 20 elementi; perp.contracts conteneva 37 elementi; spot_perp.pairs conteneva 22 elementi; delivery.contracts conteneva 53 elementi; coverage.unavailable conteneva 4 elementi; coverage.included_exchanges conteneva 20 elementi.

  • {
    • "success": true,
    • "schema": "coinboss.sd.basis/1",
    • "now": 1794541956692,
    • "coin": "BTC",
    • "perp": {
      • "unit": "percent",
      • "aggregate": { … 15 },
      • "contracts": [ … 1 ]
      },
    • "spot_perp": {
      • "unit": "percent",
      • "aggregate": { … 12 },
      • "pairs": [ … 1 ]
      },
    • "delivery": {
      • "unit": "percent",
      • "contracts": [ … 1 ]
      },
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "unavailable": [ … 1 ],
      • "stale_excluded": [],
      • "missing_fields": [],
      • "excluded_from_aggregate": [ … 1 ],
      • "stock_excluded": [],
      • "dropped_delisted_rows": 0,
      • "delivery_unavailable": [ … 1 ]
      },
    • "method": {
      • "perp.basis_pct": "(mark_price - index_price) / index_price * 100, percent; mark and index are both published by the same exchange for that…",
      • "perp.basis_last_pct": "(last_price - index_price) / index_price * 100; null when the exchange gives no last-trade price or the last trade is mo…",
      • "perp.aggregate.oi_weighted_pct": "sum(basis_pct * oi_usd) / sum(oi_usd) over all included perpetual contracts that have an open-interest weight; oi_usd fr…",
      • "perp.aggregate.vol_weighted_pct": "same with 24h notional volume (market_tickers.volume_usd / sd_contract_latest.vol_usd_24h, <= 1 h old) as weight",
      • "perp.aggregate.median_pct": "median of basis_pct over one primary contract per exchange (largest OI, then volume, then USDT-margined); mean_pct is th…",
      • "perp.aggregate.inclusion": "row is fresh (<= 180 s), basis_pct is not null, index_kind is exchange_index or oracle, the contract traded within 24 h …",
      • "spot_perp.basis_pct": "(perp last_price, or mark_price when last is unusable - spot last price * spot_mult) / (spot last price * spot_mult) * 1…",
      • "spot_perp.aggregate.inclusion": "as perp, plus spot 24h turnover >= 10000 (quote currency) when the exchange reports it",
      • "delivery.basis_pct": "(F - S) / S * 100 with F = mark_price and S = the exchange index price of the underlying; basis_last_pct uses F = last_p…",
      • "delivery.annualized_pct": "basis_pct * 365 / days_to_expiry, simple (not compounded); null when days_to_expiry < 1; days_to_expiry = (expiry_ts - p…",
      • "index_lag_s": "seconds between the mark timestamp and the index timestamp of the row; 0 when the exchange returns both in one response;…",
      • "multiplier": "contract units per coin (1000PEPE, kPEPE = 1000); mark and index carry the same multiplier so basis_pct is unaffected; s…"
      },
    • "meta": {
      • "schema": "coinboss.sd.basis/1",
      • "source": [ … 1 ],
      • "observed_at": 1794539247345,
      • "received_at": 1794539247425,
      • "fetched_at": 1794541956692,
      • "window": "latest",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 20,
      • "fallback": "rows older than 180 s are excluded; if no exchange is fresh the last stored rows (<= 1 h old) are served with is_stale=t…",
      • "collector_heartbeat_age_s": 2759
      }
    }

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=ETH20028 msSuperato STALE
coin=SOL20026 msSuperato STALE
coin=PEPE20026 msSuperato STALE
—4002 msSuperato restituisce l'errore previsto

Verificato 2026-11-13 03:28:06 UTC

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
20s
Micro-cache edge
10s
Frequenza di aggiornamento
Ciclo del collector ogni 60 secondi; una riga è aggiornata per 180 secondi. Le istantanee orarie alimentano lo storico.
Finestra
Ultimo valore per contratto.
Fonti dei dati
Prezzo mark, prezzo dell'indice e ultimo prezzo pubblicati da 21 exchange di derivati, più il prezzo spot dello stesso exchange, raccolti e archiviati da CoinBoss (sd_px_latest, sd_px_hourly).
Copertura degli exchange
21 exchange. Gli exchange che non pubblicano un prezzo dell'indice o un prezzo mark sono elencati in `coverage.unavailable`; le righe le cui due gambe di prezzo distano più di 60 secondi restituiscono `null`. Le righe escluse dall'aggregato sono elencate in `coverage.excluded_from_aggregate` con il motivo.
Paginazione
Nessuna paginazione.
Ordinamento
Prima i contratti con l'open interest maggiore.
Unità
All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
Metodo
Perpetual: basis_pct = (mark − index) ÷ index × 100. Spot-perp: (perpetual price − spot price) ÷ spot price × 100, same exchange and quote currency. Delivery: basis_pct = (futures − index) ÷ index × 100; annualized_pct = basis_pct × 365 ÷ days to expiry (simple interest; `null` inside the last day). Aggregates use one primary contract per exchange; a row enters only if it is fresh, traded within 24 hours and |basis| ≤ 10 %.
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

DegradatoVerificato 2026-11-13 03:52:48 UTCHTTP 2001 msSchema conformeDato più recente risalente a 45m fa

L'endpoint segnala una qualità dei dati STALE

Disponibilità, ultimi 30 giorni

100% di 406 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/sd/basisDegradato
Parametri

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

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