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

Storico della capitalizzazione totale del mercato crypto e delle principali monete

Storico della capitalizzazione totale del mercato crypto e delle principali monete

GET/api/indicators/marketcap

Richiesta

Questo endpoint non accetta parametri.

Richiesta di esempio

curl -s "https://www.coinboss.com/api/indicators/marketcap"

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 }`.
updated_atnumbermsMomento dell'ultimo aggiornamento di questa riga.
coverageobject—Che cosa è incluso e che cosa manca.
coverage.coinsnumber—Monete.
coverage.notestring—Nota.
total_mcapnumberUSDSomma delle capitalizzazioni di mercato delle monete tracciate (righe aggiornate nelle ultime 24 ore, escluse le anomalie della fonte a monte).
vol_24hnumberUSDSomma del volume di scambio a 24h delle stesse monete.
breakdownobject—Ripartizione di `total_mcap` tra BTC, ETH, stablecoin e tutte le altre monete, in USD e in percentuale.
breakdown.btcnumber—Valore per BTC.
breakdown.ethnumber—Valore per ETH.
breakdown.stablenumberUSDCapitalizzazione di mercato complessiva delle principali stablecoin elencate (USDT, USDC, DAI e altre).
breakdown.altnumberUSD`total_mcap` meno BTC, ETH e stablecoin.
breakdown.btc_pctnumber%Capitalizzazione di mercato di BTC ÷ `total_mcap` × 100.
breakdown.eth_pctnumber%Capitalizzazione di mercato di ETH ÷ `total_mcap` × 100.
breakdown.stable_pctnumber%`breakdown.stable` ÷ `total_mcap` × 100.
breakdown.alt_pctnumber%`breakdown.alt` ÷ `total_mcap` × 100.
top10array—Prime dieci voci.
top10[]object—Prime dieci voci.
top10[].coinstring—Simbolo della moneta, in maiuscolo (per esempio BTC).
top10[].mcapnumber—Capitalizzazione di mercato.
top10[].sharenumber—Quota sul totale.
historyarray—Punti storici, dal meno recente, salvo diversa indicazione.
history[]object—Punti storici, dal meno recente, salvo diversa indicazione.
history[].datestring—Data di calendario (UTC).
history[].totalnumber—Totale.
history[].btcnumber—Valore per BTC.
history[].ethnumber—Valore per ETH.
history[].stablenumberUSDCapitalizzazione di mercato delle stablecoin nell'istantanea di quel giorno stesso.
dominance_historyarray—Dominance nel tempo.
dominance_history[]array—Dominance nel tempo.
dominance_history[][]number—Dominance nel tempo.

Generata 2026-11-11 23:01 UTC da 1 risposte reali.

Risposta di esempio

/api/indicators/marketcap · Risposta reale acquisita 2026-11-13 03:53:42 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: top10 conteneva 10 elementi; history conteneva 98 elementi; dominance_history conteneva 1340 elementi.

  • {
    • "success": true,
    • "updated_at": 1794541978352,
    • "coverage": {
      • "coins": 2214,
      • "note": "CoinGecko top-listed coins only; rows refreshed within 24h; rows with market cap > $10B and 24h turnover < 0.0001% are excluded as upstream anomalies"
      },
    • "total_mcap": 2419216305601.422,
    • "vol_24h": 130272448234.72011,
    • "breakdown": {
      • "btc": 1388749788148,
      • "eth": 238606491245,
      • "stable": 273094600801,
      • "alt": 518765425407.4219,
      • "btc_pct": 57.4,
      • "eth_pct": 9.86,
      • "stable_pct": 11.29,
      • "alt_pct": 21.44
      },
    • "top10": [
      • { … 3 },
      • { … 3 }
      ],
    • "history": [
      • { … 5 },
      • { … 5 }
      ],
    • "dominance_history": [
      • [ … 2 ],
      • [ … 2 ]
      ]
    }

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
10m
Micro-cache edge
10s
Frequenza di aggiornamento
aggregatore di dati di mercato di terze parti ogni 10 min; punto di storico giornaliero aggiunto su richiesta; storico della dominance ogni giorno; cache dell'API 600 s
Finestra
istantanea attuale; storico giornaliero proprio dal 2026-07-05
Fonti dei dati
Capitalizzazione di mercato totale delle crypto e relativa ripartizione BTC / ETH / stablecoin / altcoin, calcolata dalle capitalizzazioni di mercato di un aggregatore di dati di mercato di terze parti; storico di lungo periodo della dominance di BTC da bitcoin-data.com.
Copertura degli exchange
Circa 2200 monete che superano il controllo di freschezza e dei valori anomali
Paginazione
nessuno
Unità
USD; shares in percent
Metodo
total = SUM(market cap) over rows refreshed within 24h, excluding outliers (mcap > 10B USD with 24h volume < mcap * 1e-6); alt = total - btc - eth - stable (15 symbols)
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:53:42 UTCHTTP 2001 msSchema conformeDato più recente risalente a 44s fa

Disponibilità, ultimi 30 giorni

100% di 407 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/indicators/marketcapDisponibile
Parametri

Nessun parametro.

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