Riepilogo delle sezioni dell'intero sito
Riepilogo delle sezioni dell'intero sito (per le pagine di contenuto)
/api/content/summaryRichiesta
Questo endpoint non accetta parametri.
Richiesta di esempio
curl -s "https://www.coinboss.com/api/content/summary"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.
| Campo | Tipo | Unità | Descrizione |
|---|---|---|---|
| success | boolean | — | true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`. |
| now | number | ms | Ora del server al momento della composizione della risposta. |
| exchanges | object | — | Exchange. |
| exchanges.count | number | — | Numero di elementi. |
| exchanges.total_vol | number | USD | Volume futures a 24h sommato su tutti gli exchange, esclusi i contratti legati ad azioni. |
| exchanges.total_oi | number | — | Open interest totale. |
| exchanges.total_contracts | number | count | Numero di ticker di contratti futures su tutti gli exchange, esclusi i contratti legati ad azioni. |
| exchanges.top3 | array | — | Prime tre voci. |
| exchanges.top3[] | object | — | Prime tre voci. |
| exchanges.top3[].name | string | — | Nome. |
| exchanges.top3[].vol | number | — | Volume. |
| exchanges.top3[].share_pct | number | % | Quota sul totale. |
| exchanges.dex_share_vol_pct | number | % | Quota di `total_vol` scambiata sugli exchange decentralizzati di perpetui. |
| exchanges.dex_share_oi_pct | number | % | Quota di `total_oi` detenuta sugli exchange decentralizzati di perpetui. |
| exchanges.stock_vol_excluded | number | USD | Volume a 24h dei contratti legati ad azioni che è stato escluso da `total_vol`. |
| funding | object | — | Blocco o valore del tasso di finanziamento. |
| funding.weighted_pct | number | % | Tasso di finanziamento attuale dei perpetui crypto USDT ponderato per l'open interest, in percentuale per intervallo di finanziamento (i tassi non sono normalizzati a 8 ore). |
| funding.top_pos | array | — | I tre tassi di finanziamento attuali più alti tra i perpetui USDT con almeno 300.000 USD di open interest. |
| funding.top_pos[] | object | — | Un contratto: `base` (moneta), `ex` (nome visualizzato dell'exchange) e `rate_pct`. |
| funding.top_pos[].base | string | — | Simbolo dell'asset di base. |
| funding.top_pos[].ex | string | — | ID dell'exchange, in minuscolo. |
| funding.top_pos[].rate_pct | number | % | Tasso di finanziamento attuale del contratto in percentuale, per il suo intervallo di finanziamento. |
| funding.top_neg | array | — | I tre tassi di finanziamento attuali più bassi (più negativi) tra i perpetui USDT con almeno 300.000 USD di open interest. |
| funding.top_neg[] | object | — | Un contratto: `base` (moneta), `ex` (nome visualizzato dell'exchange) e `rate_pct`. |
| funding.top_neg[].base | string | — | Simbolo dell'asset di base. |
| funding.top_neg[].ex | string | — | ID dell'exchange, in minuscolo. |
| funding.top_neg[].rate_pct | number | % | Tasso di finanziamento attuale del contratto in percentuale, per il suo intervallo di finanziamento. |
| funding.intervals | object | — | Intervalli. |
| funding.intervals.h1_pct | number | % | Quota di contratti che hanno regolato il finanziamento 16 o più volte nelle ultime 24 ore (classificati come orari). |
| funding.intervals.h4_pct | number | % | Quota di contratti che hanno regolato il finanziamento da 5 a 15 volte nelle ultime 24 ore (classificati come a 4 ore). |
| funding.intervals.h8_pct | number | % | Quota di contratti che hanno regolato il finanziamento meno di 5 volte nelle ultime 24 ore (classificati come a 8 ore). |
| oi | object | — | Open interest. |
| oi.total | number | — | Totale. |
| oi.chg24_pct | number | % | Variazione dell'open interest sommato rispetto all'istantanea oraria di circa 24 ore prima, sui contratti presenti in entrambe; null quando non esiste alcuna istantanea. |
| oi.gainers | array | — | Maggiori rialzi. |
| oi.gainers[] | object | — | Maggiori rialzi. |
| oi.gainers[].base | string | — | Simbolo dell'asset di base. |
| oi.gainers[].oi | number | — | Open interest. |
| oi.gainers[].chg_pct | number | % | Variazione percentuale. |
| oi.losers | array | — | Maggiori ribassi. |
| oi.losers[] | object | — | Maggiori ribassi. |
| oi.losers[].base | string | — | Simbolo dell'asset di base. |
| oi.losers[].oi | number | — | Open interest. |
| oi.losers[].chg_pct | number | % | Variazione percentuale. |
| oi.top_ex | array | — | I tre exchange con il maggiore open interest. |
| oi.top_ex[] | object | — | Un exchange: `name`, `oi` (USD) e `share_pct` (% di `oi.total`). |
| oi.top_ex[].name | string | — | Nome. |
| oi.top_ex[].oi | number | — | Open interest. |
| oi.top_ex[].share_pct | number | % | Quota sul totale. |
| market | object | — | Mercato. |
| market.total_oi | number | — | Open interest totale. |
| market.liq_total | number | USD | Liquidazioni long più short nelle ultime 24 ore, esclusi i contratti legati ad azioni. |
| market.liq_long | number | — | Long liquidati. |
| market.liq_short | number | — | Short liquidati. |
| market.up_cnt | number | count | Numero delle prime 500 monete per capitalizzazione di mercato la cui variazione di prezzo a 24h è positiva. |
| market.down_cnt | number | count | Numero delle prime 500 monete per capitalizzazione di mercato la cui variazione di prezzo a 24h è negativa. |
| market.btc_dom_pct | number | % | Capitalizzazione di mercato di BTC ÷ capitalizzazione di mercato totale delle monete tracciate × 100; null quando l'istantanea delle capitalizzazioni di mercato non è disponibile. |
| stocks | object | — | Contratti perpetui legati ad azioni con un ticker delle ultime 12 ore: numero di sottostanti, contratti, exchange, volume a 24h e i primi 3 sottostanti. |
| stocks.underlyings | number | — | Simboli dei sottostanti. |
| stocks.contracts | number | — | Righe per contratto. |
| stocks.vol | number | — | Volume. |
| stocks.exchanges | number | — | Exchange. |
| stocks.top3 | array | — | Prime tre voci. |
| stocks.top3[] | object | — | Prime tre voci. |
| stocks.top3[].u | string | — | Ticker dell'azione o dell'ETF sottostante. |
| stocks.top3[].vol | number | — | Volume. |
| preipo | object | — | Sottostanti pre-IPO (sintetici) tra i contratti legati ad azioni: numero, volume a 24h, prezzo più alto e spread di prezzo più ampio. |
| preipo.underlyings | number | — | Simboli dei sottostanti. |
| preipo.vol | number | — | Volume. |
| preipo.top_price | object | — | Il sottostante pre-IPO con il prezzo dei contratti ponderato per il volume più alto (`u`, `price`); null quando nessuno è scambiato. |
| preipo.top_price.u | string | — | Nome di quel sottostante. |
| preipo.top_price.price | number | — | Ultimo prezzo nella valuta di quotazione (USD o USDT, salvo diversa indicazione). |
| preipo.max_spread | object | — | Il sottostante pre-IPO con il divario di prezzo più ampio tra i suoi contratti (`u`, `spread_pct`, `pmin`, `pmax`); null quando nessuno ha due contratti. |
| preipo.max_spread.u | string | — | Nome di quel sottostante. |
| preipo.max_spread.spread_pct | number | % | (`pmax` − `pmin`) ÷ `pmin` × 100. |
| preipo.max_spread.pmin | number | USD | Prezzo attuale più basso dei contratti del sottostante tra gli exchange. |
| preipo.max_spread.pmax | number | USD | Prezzo attuale più alto dei contratti del sottostante tra gli exchange. |
Generata 2026-11-11 23:01 UTC da 1 risposte reali.
Risposta di esempio
/api/content/summary · Risposta reale acquisita 2026-11-13 03:53:48 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: oi.losers conteneva 3 elementi; oi.top_ex conteneva 3 elementi; oi.gainers conteneva 3 elementi; stocks.top3 conteneva 3 elementi; exchanges.top3 conteneva 3 elementi; funding.top_neg conteneva 3 elementi.
- "success"true
- "now"1794541766928
- "exchanges"
- "count"25
- "total_vol"169675954910.26993
- "total_oi"107737040199.58
- "total_contracts"10843
- "top3"
- "dex_share_vol_pct"8.3
- "dex_share_oi_pct"11.3
- "stock_vol_excluded"41319457587.51
- "funding"
- "weighted_pct"0.0047
- "top_pos"
- "top_neg"
- "intervals"
- "oi"
- "total"107737040199.58
- "chg24_pct"-3.33
- "gainers"
- "losers"
- "top_ex"
- "market"
- "total_oi"107737040199.58
- "liq_total"1197925242.48
- "liq_long"1104557190
- "liq_short"93368052.48
- "up_cnt"150
- "down_cnt"327
- "btc_dom_pct"57.4
- "stocks"
- "underlyings"648
- "contracts"2338
- "vol"41225031460.52995
- "exchanges"18
- "top3"
- "preipo"
- "underlyings"3
- "vol"2214168764.27
- "top_price"
- "max_spread"
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
- ticker ogni 1 min; OI/finanziamento ogni 5 min; cache dell'API 600 s
- Finestra
- 24h
- Fonti dei dati
- Dati di sintesi dell'intero sito (quote di volume e di OI per exchange, estremi del finanziamento, maggiori variazioni di OI, liquidazioni, statistiche sui contratti su azioni tokenizzate e pre-IPO) aggregati internamente dai dati degli exchange; dominance di BTC e conteggi di rialzi/ribassi da un aggregatore di dati di mercato di terze parti.
- Copertura degli exchange
- Tutti gli exchange di derivati raccolti; contratti su azioni tokenizzate esclusi dai totali crypto
- Paginazione
- nessuno
- Unità
- USD; percentages
- Metodo
- funding.weighted_pct = SUM(rate * oi) / SUM(oi) * 100 over USDT perpetuals refreshed within 3h (not normalized to 8h); oi.chg24_pct compares contracts present both now and 24h ago
- Timestamp
- Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
- Formato della risposta
- json
- Stabilità
- Beta
Stato in tempo reale
Disponibilità, ultimi 30 giorni
99.75% 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 →
| Codice | HTTP | Significato | Che cosa fare |
|---|---|---|---|
| INVALID_PARAM | 400 | Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto. | Non riprovare senza modifiche; correggere la richiesta. |
| UNAUTHORIZED | 401 | L'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. |
| FORBIDDEN | 403 | La route non fa parte dell'API pubblica (interna o riservata agli account). | Non riprovare. |
| NOT_FOUND | 404 | Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste. | Non riprovare; verificare il percorso e gli identificatori nel catalogo. |
| RATE_LIMITED | 429 | Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere. | Attendere `Retry-After`, poi riprovare con backoff. |
| INTERNAL | 500 | Errore 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_FAILED | 503 | La 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. |
| UNAVAILABLE | 501 / 503 | Il 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_FAILED | 200 | Alcuni 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
/api/content/summaryDisponibileNessun parametro.
https://www.coinboss.com/api/content/summaryAltro in questa categoria
- Matrice della qualità dei dati (vista del collector) /api/sd/quality
- Catalogo dell'API /api/meta/catalog
- Registro delle modifiche e politica di versionamento /api/meta/changelog
- Documentazione di un endpoint /api/meta/endpoint
- Documento OpenAPI /api/meta/openapi
- Matrice della qualità dei dati /api/meta/quality
- Stato del servizio /api/meta/status
- Verifica se il simbolo di una moneta è noto alla piattaforma /api/coin-exists
- Mappa dal simbolo della moneta al percorso dell'icona ospitata in locale /api/coin-icons
- Riepilogo aggregato della pagina moneta /api/content/coin
- Riepilogo delle sezioni dell'intero sito /api/content/summary
- Tabella dei tassi di cambio fiat /api/currency/fx
- Mappa dall'ID dell'exchange al percorso dell'icona ospitata in locale /api/exchange-icons
- Controllo di liveness /api/health
- Statistiche della pagina di ricerca /api/research/stats