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

Monete classificate per base

Monete classificate per base mediana tra exchange, con media, base ponderata per OI, open interest e gli exchange con il valore più basso e più alto.

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

Richiesta

Parametri di query

NomeTipoObbligatorioPredefinitoValori ammessiDescrizione
kindstringFacoltativoperpperp, spot_perp`perp`: prezzo mark rispetto al prezzo dell'indice dello stesso exchange. `spot_perp`: prezzo del perpetuo rispetto al prezzo spot dello stesso exchange.
sortstringFacoltativobasis_descbasis_desc, basis_asc, abs_descChiave di ordinamento: prima la base mediana più alta, più bassa o maggiore in valore assoluto.
limitintegerFacoltativo50≥ 1 · ≤ 200Numero di righe.
min_exchangesintegerFacoltativo3≥ 1 · ≤ 20Solo le monete con una base su almeno questo numero di exchange.

Richiesta di esempio

curl -s "https://www.coinboss.com/api/sd/basis/rank"

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.
kindstring—`perp` o `spot_perp`.
sortstring—Ordinamento applicato.
limitnumber—Limite di righe applicato.
min_exchangesnumber—Numero minimo di exchange applicato.
totalnumber—Righe disponibili prima dell'applicazione di `limit`.
countnumber—Righe restituite.
dataarray—Una riga per moneta.
data[]object—Una riga per moneta.
data[].ranknumber—Posizione in classifica; `null` quando la riga non ha un valore da classificare.
data[].coinstring—Simbolo della moneta (in maiuscolo).
data[].basis_pctnumber%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
data[].mean_pctnumber%Media semplice sullo stesso insieme della mediana.
data[].oi_weighted_pctnumber%Base ponderata per open interest; le righe senza un peso OI sono escluse.
data[].oi_usdnumberUSDOpen interest del contratto, unilaterale; usato come peso.
data[].n_exchangesnumber—Exchange inclusi nell'aggregato.
data[].n_contractsnumber—Contratti inclusi nell'aggregato.
data[].minobject—Exchange e contratto con la base più bassa.
data[].min.exchangestring—ID dell'exchange (in minuscolo).
data[].min.symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
data[].min.basis_pctnumber%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
data[].maxobject—Exchange e contratto con la base più alta.
data[].max.exchangestring—ID dell'exchange (in minuscolo).
data[].max.symbolstring—Simbolo del contratto nella forma di archiviazione di CoinBoss.
data[].max.basis_pctnumber%(mark − index) ÷ index × 100 per i perpetui e i contratti a scadenza; nelle classifiche, la mediana tra exchange.
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
methodobject—Enunciato in testo semplice delle formule usate per questa risposta, una voce per campo.
method.basis_pctstring—Nota sulla formula di `basis_pct`, in testo semplice.
method.oi_weighted_pctstring—Nota sulla formula di `oi_weighted_pct`, in testo semplice.
method.inclusionstring—Nota sulla formula di `inclusion`, in testo semplice.
method.coinstring—Nota sulla formula di `coin`, 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.

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

Risposta di esempio

/api/sd/basis/rank · Risposta reale acquisita 2026-11-13 03:58:08 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: coverage.stale_excluded conteneva 21 elementi.

  • {
    • "success": true,
    • "schema": "coinboss.sd.basis/1",
    • "now": 1794542288498,
    • "kind": "perp",
    • "sort": "basis_desc",
    • "limit": 50,
    • "min_exchanges": 3,
    • "total": null,
    • "count": null,
    • "data": null,
    • "coverage": {
      • "included_exchanges": [],
      • "unavailable": [],
      • "stale_excluded": [ … 2 ]
      },
    • "method": {
      • "basis_pct": "median over exchanges (one primary contract per exchange) of the perpetual mark-vs-index basis, percent; the ranking key",
      • "oi_weighted_pct": "OI-weighted mean over all included contracts of the coin (single-sided OI, <= 3 h old); null when no contract has a weight",
      • "inclusion": "fresh rows only (<= 180 s); same row filters as /api/sd/basis; catalogued stock/ETF perpetuals (stock_contracts) are removed; coins quoted on fewer than min_exc…",
      • "coin": "multiplier contracts are folded into the underlying coin (1000PEPE, kPEPE -> PEPE)"
      },
    • "meta": {
      • "schema": "coinboss.sd.basis/1",
      • "source": [],
      • "observed_at": null,
      • "received_at": null,
      • "fetched_at": 1794542288498,
      • "window": "latest",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 30,
      • "fallback": "only rows refreshed within 180 s are ranked; when the collector is down the list is empty and quality is STALE",
      • "collector_heartbeat_age_s": 3091
      }
    }

Campioni verificati

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

ParametriHTTPLatenzaRisultato
kind=spot_perp2002 msSuperato STALE
sort=basis_asc&limit=102002 msSuperato STALE
sort=zzz4002 msSuperato restituisce l'errore previsto

Verificato 2026-11-13 03:58:08 UTC

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
30s
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; `limit` fissa il numero massimo di righe (max 200).
Ordinamento
Controllato da `sort`; la chiave di ordinamento è la mediana tra exchange (`basis_pct`).
Unità
All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
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:58:08 UTCHTTP 20023 msSchema conforme

L'endpoint segnala una qualità dei dati STALE

Disponibilità, ultimi 30 giorni

100% di 407 verifiche superate

Deriva dello schema rilevata dall'ultima verifica della sonda
  • Restituito ma non documentato: coverage.stale_excluded[], coverage.stale_excluded[].exchange, coverage.stale_excluded[].age_s

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/basis/rankDegradato
Parametri

string · predefinito perp — `perp`: mark price against the index price of the same exchange. `spot_perp`: perpetual price against the spot price of the same exchange.

string · predefinito basis_desc — Sort key: highest, lowest or largest absolute median basis first.

integer · predefinito 50 · min 1 · max 200 — Number of rows.

integer · predefinito 3 · min 1 · max 20 — Only coins with a basis on at least this many exchanges.

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