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

Panoramica di dettaglio di una moneta

Panoramica di dettaglio di una moneta (prezzo, capitalizzazione di mercato, offerta, sintesi dei derivati)

GET/api/currency/overview

Richiesta

Parametri di query

NomeTipoObbligatorioPredefinitoValori ammessiDescrizione
coinstringObbligatorio——Simbolo della moneta di base (in maiuscolo, ad es. BTC). Esempio: BTC

Richiesta di esempio

curl -s "https://www.coinboss.com/api/currency/overview?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 }`.
dataobject—Payload.
data.coinstring—Simbolo della moneta, in maiuscolo (per esempio BTC).
data.supplyobject—Offerta in monete.
data.supply.price_usdstring(decimal)USDPrezzo.
data.supply.market_cap_usdstring(decimal)USDCapitalizzazione di mercato.
data.supply.mcap_ranknumber—Posizione in classifica per capitalizzazione di mercato.
data.supply.vol_24h_usdstring(decimal)USDVolume a 24h.
data.supply.circulatingstring(decimal)—Offerta circolante in monete.
data.supply.total_supplystring(decimal)—Offerta totale in monete.
data.supply.max_supplystring(decimal)|null—Offerta massima in monete; null quando è illimitata o sconosciuta.
data.supply.change_24h_pctstring(decimal)%Variazione percentuale a 24h.
data.supply.image_urlstring—Percorso dell'icona sulla stessa origine, servita da CoinBoss; null quando non esiste un'icona verificata.
data.supply.website_urlstring—Sito web ufficiale del progetto, dai metadati della moneta.
data.supply.reddit_urlstring|null—Subreddit del progetto; null quando non ne è indicato alcuno.
data.supply.github_urlstring|null—Repository principale del codice sorgente del progetto; null quando non ne è indicato alcuno.
data.supply.whitepaper_urlstring—Link al whitepaper del progetto.
data.supply.explorer_urlstring—Link a un block explorer della moneta.
data.supply.categorystring—Categoria.
data.supply.asofnumbermsOra del dato più recente utilizzato.
data.supply.staleboolean—Righe o flag relativi ai dati più vecchi della finestra di freschezza.
data.supply.spot_vol_usdnumberUSDSomma del volume spot a 24h della moneta sugli exchange spot raccolti direttamente da CoinBoss (ultima istantanea); null quando non viene raccolto.
data.supply.futures_vol_usdnumberUSDSomma del volume futures a 24h su tutti gli exchange con un ticker più recente di 1 ora, stesso valore di `futures_vol.total_usd`; null in assenza di dati propri.
data.supply.oi_total_usdnumberUSDOpen interest aggregato della moneta su tutti gli exchange e tutti i tipi di contratto, stesso valore di `oi.total_usd`; null in assenza di dati propri.
data.supply.high_24hstring(decimal)—Massimo a 24h.
data.supply.low_24hstring(decimal)—Minimo a 24h.
data.futures_vol_chg_pctnumber%Variazione a 24h del volume futures: exchange presenti sia ora sia nell'istantanea oraria di circa 24 ore fa, (Σ attuale − Σ precedente) ÷ Σ precedente.
data.oi_chg_pctnumber%Variazione a 24h dell'open interest calcolata sui contratti presenti sia ora sia nell'istantanea oraria più vicina a 24 ore fa.
data.oiobject—Open interest.
data.oi.total_usdnumberUSDTotale.
data.oi.local_usdnumberUSDOpen interest sommato dalla raccolta per exchange di CoinBoss; identico a `oi.total_usd`.
data.oi.by_exchangearray—Ripartizione per exchange.
data.oi.by_exchange[]object—Ripartizione per exchange.
data.oi.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
data.oi.by_exchange[].oi_usdnumberUSDOpen interest in nozionale USD.
data.oi.n_exchangesnumber—Numero di exchange che contribuiscono.
data.oi.asofnumbermsOra del dato più recente utilizzato.
data.oi.chg_basisobject—Dati di ingresso di `oi_chg_pct`: somme attuale e precedente abbinate (`cur`, `prev`), numero di exchange abbinati, ora della base di confronto e contratti congelati esclusi.
data.oi.chg_basis.curnumber—Valore attuale.
data.oi.chg_basis.prevnumber—Valore precedente (base di confronto).
data.oi.chg_basis.n_matchednumber—Elementi presenti a entrambi gli estremi del confronto.
data.oi.chg_basis.prev_hour_tsnumbermsInizio del bucket orario precedente.
data.oi.chg_basis.frozen_excludedobject—Righe escluse perché il valore alla fonte non è variato.
data.oi.chg_basis.frozen_excluded.n_baselinenumber—Elementi nell'istantanea di confronto.
data.oi.chg_basis.frozen_excluded.n_currentnumber—Elementi nell'istantanea attuale.
data.oi.chg_basis.frozen_excluded.cur_usdnumberUSDValore attuale.
data.oi.chg_basis.frozen_excluded.prev_usdnumberUSDValore di confronto.
data.futures_volobject—Volume dei futures.
data.futures_vol.total_usdnumberUSDTotale.
data.futures_vol.n_exchangesnumber—Numero di exchange che contribuiscono.
data.futures_vol.chg_basisobject—Dati di ingresso di `futures_vol_chg_pct`: somme di volume attuale e precedente abbinate (`cur`, `prev`), numero di exchange abbinati e ora della base di confronto.
data.futures_vol.chg_basis.curnumber—Valore attuale.
data.futures_vol.chg_basis.prevnumber—Valore precedente (base di confronto).
data.futures_vol.chg_basis.n_matchednumber—Elementi presenti a entrambi gli estremi del confronto.
data.futures_vol.chg_basis.prev_hour_tsnumbermsInizio del bucket orario precedente.
data.fundingnumber—Blocco o valore del tasso di finanziamento.
data.funding_detailobject—Dettaglio alla base di `funding`: tassi normalizzati a 8h, semplice e ponderato per open interest, tasso annualizzato, conteggi degli exchange e una voce per exchange.
data.funding_detail.basisstring—Prezzo futures meno prezzo spot, oppure il blocco della base.
data.funding_detail.avg_8hnumber—Media dei tassi normalizzati a 8h.
data.funding_detail.oi_weighted_8hnumber—Media ponderata per open interest dei tassi normalizzati a 8h.
data.funding_detail.apr_pctnumber% per yearPercentuale annualizzata.
data.funding_detail.n_exchangesnumber—Numero di exchange che contribuiscono.
data.funding_detail.n_normalizednumber—Exchange normalizzati a 8h.
data.funding_detail.n_unknown_intervalnumber—Exchange con intervallo di finanziamento sconosciuto.
data.funding_detail.by_exchangearray—Ripartizione per exchange.
data.funding_detail.by_exchange[]object—Ripartizione per exchange.
data.funding_detail.by_exchange[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
data.funding_detail.by_exchange[].symbolstring—Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT).
data.funding_detail.by_exchange[].ratenumber—Tasso.
data.funding_detail.by_exchange[].interval_hnumberhIntervallo.
data.funding_detail.by_exchange[].rate_8hnumber—Tasso normalizzato a un periodo di 8 ore.
data.funding_detail.by_exchange[].next_funding_timenumber|nullmsTimestamp.
data.long_shortobject—Blocco long/short.
data.long_short.longnumber—Valore del lato long.
data.long_short.shortnumber—Valore del lato short.
data.long_short.rationumber—Rapporto.
data.long_short.typestring—Tipo.
data.long_short.n_exchangesnumber—Numero di exchange che contribuiscono.
data.derivedobject—Indicatori della moneta ricalcolati periodicamente (RSI, base, open interest aggregato, finanziamento medio, quote long/short, liquidazioni a 24h); null quando non sono calcolati.
data.derived.rsi_1hstring(decimal)—RSI(14) su candele a 1h.
data.derived.rsi_4hstring(decimal)—RSI(14) su candele a 4h.
data.derived.rsi_1dstring(decimal)—RSI(14) su candele giornaliere.
data.derived.basis_pctstring(decimal)|null%(futures − spot) / spot × 100.
data.derived.basis_annual_pctnull% per yearBase annualizzata in funzione dei giorni alla scadenza.
data.derived.oi_usd_aggstring(decimal)USDOpen interest aggregato su tutti gli exchange e tutti i tipi di contratto all'ultimo aggiornamento degli indicatori; può essere leggermente in ritardo rispetto a `oi.total_usd`.
data.derived.funding_avgstring(decimal)—Tasso di finanziamento medio tra gli exchange.
data.derived.ls_accountstring(decimal)—Rapporto long/short per account.
data.derived.ls_takerstring(decimal)|null—Rapporto acquisti/vendite taker.
data.derived.liq_24h_usdstring(decimal)USDLiquidazioni a 24h.
data.liquidationobject—Blocco delle liquidazioni. chiavi dinamiche: 1h,4h,12h,24h
data.liquidation.{*}object—Blocco delle liquidazioni.
data.liquidation.{*}.winstring—Etichetta della finestra della voce, che ne ripete la chiave (`1h`, `4h`, `12h` o `24h`).
data.liquidation.{*}.long_usdnumberUSDLato long.
data.liquidation.{*}.short_usdnumberUSDLato short.
data.liquidation.{*}.total_usdnumberUSDTotale.
data.liquidation.{*}.cntnumber—Numero.

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

Risposta di esempio

/api/currency/overview?coin=BTC · Risposta reale acquisita 2026-11-13 03:57:31 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: data.liquidation conteneva 4 elementi; data.oi.by_exchange conteneva 22 elementi; data.funding_detail.by_exchange conteneva 23 elementi.

  • {
    • "success": true,
    • "data": {
      • "coin": "BTC",
      • "supply": { … 22 },
      • "futures_vol_chg_pct": 67.76,
      • "oi_chg_pct": -3.65,
      • "oi": { … 6 },
      • "futures_vol": { … 3 },
      • "funding": 0.000057831612725940206,
      • "funding_detail": { … 8 },
      • "long_short": { … 5 },
      • "derived": { … 10 },
      • "liquidation": { … 2 }
      }
    }

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=ETH20086 msSuperato
coin=SOL20081 msSuperato
coin=ARKM20079 msSuperato

Verificato 2026-11-13 03:57:31 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
aggregatore di dati di mercato di terze parti ogni 10 min; ticker ogni 1 min; OI/finanziamento/long/short ogni 5 min (monete principali ogni 1 min); volume spot ogni 10 min; cache in memoria 30 s
Finestra
mobile a 24h per volume/liquidazioni; ultima istantanea per OI/finanziamento/long/short
Fonti dei dati
Offerta, capitalizzazione di mercato e posizione in classifica provengono da un aggregatore di dati di mercato di terze parti; prezzo, open interest, finanziamento, long/short, volume futures e spot sono aggregati internamente dalle API pubbliche degli exchange; le liquidazioni provengono dai flussi di liquidazione degli exchange.
Copertura degli exchange
Qualsiasi moneta presente nella tabella basata sull'aggregatore di dati di mercato di terze parti o con un contratto derivato quotato
Paginazione
nessuno
Unità
USD; rates as decimals; changes in percent
Metodo
OI = SUM(oi_usd) over fresh contracts incl. multiplier contracts (3h; CME 120h); funding = OI-weighted mean of rate normalized to 8h (rate * 8 / interval_hours)
Timestamp
Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
Formato della risposta
json
Stabilità
Stabile

Stato in tempo reale

DisponibileVerificato 2026-11-13 03:57:31 UTCHTTP 20095 msSchema conformeDato più recente risalente a 20s fa

Disponibilità, ultimi 30 giorni

99.76% di 411 verifiche superate

Errori

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

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

Prova

GET/api/currency/overviewDisponibile
Parametri

string — Base coin symbol (uppercase, e.g. BTC).

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