Volume 24h—Open Interest—Liquidazioni 24h$1.36BLong/Short 24h—Dominanza BTC—Dominanza ETH—
App
Lingua ▾
€ EUR ▾
/api/home/macro-cards
GETDisponibileBeta

Schede macro della homepage

Schede macro della homepage (indici azionari, dollaro, oro, ...)

GET/api/home/macro-cards

Richiesta

Questo endpoint non accetta parametri.

Richiesta di esempio

curl -s "https://www.coinboss.com/api/home/macro-cards"

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.
mcapobject—Capitalizzazione di mercato.
mcap.latestnumber—Record più recente.
mcap.datestring—Data di calendario (UTC).
mcap.chg24h_pctnumber%Variazione percentuale a 24h.
mcap.sparkarray—Brevi serie recenti per le sparkline.
mcap.spark[]number—Brevi serie recenti per le sparkline.
mcap.has_cmcboolean—true quando almeno un punto di `spark` proviene da uno storico di terze parti ricostruito a posteriori anziché dalle istantanee giornaliere proprie del sito.
volumeobject—Volume.
volume.futuresnumber—Blocco o valore del mercato futures.
volume.spotnumber—Blocco o valore del mercato spot.
volume.tsnumbermsTimestamp.
volume.sparkarray—Brevi serie recenti per le sparkline.
volume.spark[]object—Brevi serie recenti per le sparkline.
volume.spark[].tnumbermsTimestamp.
volume.spark[].fnumberUSDMedia delle letture del volume futures a 24h all'interno di quel bucket di 3 ore.
volume.spark[].snumberUSDMedia delle letture del volume spot a 24h all'interno di quel bucket di 3 ore.
btc_candlesarray—Candele BTC da sovrapporre.
btc_candles[]array—Candele BTC da sovrapporre.
btc_candles[][]number—Candele BTC da sovrapporre.
fngobject—Scheda dell'indice di paura e avidità: ultimo `value`, la sua etichetta `cls` e una `spark` dei valori giornalieri recenti; null in assenza di dati.
fng.valuenumber—Valore.
fng.clsstring—Etichetta testuale dell'ultimo valore dell'indice di paura e avidità, per esempio `Fear` o `Greed`.
fng.sparkarray—Brevi serie recenti per le sparkline.
fng.spark[]number—Brevi serie recenti per le sparkline.
stablecoinobject—Scheda delle stablecoin: valore circolante totale in USD (`total`), numero di stablecoin (`count`) e relativa variazione a 24h e a 7d.
stablecoin.totalnumber—Totale.
stablecoin.countnumber—Numero di elementi.
stablecoin.chg24h_pctnumber%Variazione percentuale a 24h.
stablecoin.chg7d_pctnumber%Variazione percentuale a 7 giorni.
liqobject—Valore o blocco delle liquidazioni.
liq.totalnumber—Totale.
liq.longnumber—Valore del lato long.
liq.shortnumber—Valore del lato short.
liq.chg24h_pctnumber%Variazione percentuale a 24h.
liq.sparkarray—Brevi serie recenti per le sparkline.
liq.spark[]number—Brevi serie recenti per le sparkline.

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

Risposta di esempio

/api/home/macro-cards · Risposta reale acquisita 2026-11-13 03:59:25 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: fng.spark conteneva 30 elementi; liq.spark conteneva 57 elementi; mcap.spark conteneva 90 elementi; btc_candles conteneva 42 elementi; volume.spark conteneva 57 elementi.

  • {
    • "success": true,
    • "updated_at": 1794542365066,
    • "mcap": {
      • "latest": 2476085584564.88,
      • "date": "2026-11-13",
      • "chg24h_pct": -3.19,
      • "spark": [ … 8 ],
      • "has_cmc": false
      },
    • "volume": {
      • "futures": 216570771117.84,
      • "spot": 66073226871.26,
      • "ts": 1794541800000,
      • "spark": [ … 2 ]
      },
    • "btc_candles": [
      • [ … 5 ],
      • [ … 5 ]
      ],
    • "fng": {
      • "value": 20,
      • "cls": "Extreme Fear",
      • "spark": [ … 8 ]
      },
    • "stablecoin": {
      • "total": 288099833329.21,
      • "count": 353,
      • "chg24h_pct": -0.53,
      • "chg7d_pct": -1.71
      },
    • "liq": {
      • "total": 1363532410.6799946,
      • "long": 1267567542.2399952,
      • "short": 95964868.44,
      • "chg24h_pct": 501.86,
      • "spark": [ … 8 ]
      }
    }

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
2m
Micro-cache edge
10s
Frequenza di aggiornamento
capitalizzazione di mercato ogni giorno; volume ogni 10 min; candele ogni 5 min; paura e avidità ogni giorno; stablecoin ogni 10 min; cache dell'API 120 s
Finestra
capitalizzazione di mercato 90 giorni; volume 7 giorni; candele BTC a 4h; paura e avidità 30 giorni; liquidazioni 24h
Fonti dei dati
Schede macro della home page: capitalizzazione di mercato totale (istantanea giornaliera delle capitalizzazioni di mercato di un aggregatore di dati di mercato di terze parti), volume futures e liquidazioni (dati degli exchange), candele BTC (Binance), paura e avidità (alternative.me) e offerta di stablecoin (fonte di terze parti).
Copertura degli exchange
Intero mercato
Paginazione
nessuno
Unità
USD; changes in percent; Fear & Greed 0-100
Timestamp
Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
Formato della risposta
json
Stabilità
Beta

Stato in tempo reale

DisponibileVerificato 2026-11-13 03:53:42 UTCHTTP 2001 msSchema conformeDato più recente risalente a 36s fa

Disponibilità, ultimi 30 giorni

100% di 408 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/home/macro-cardsDisponibile
Parametri

Nessun parametro.

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