Volume 24h—Open Interest—Liquidazioni 24h$1.36BLong/Short 24h—Dominanza BTC—Dominanza ETH—
App
Lingua ▾
€ EUR ▾
/api/meta/status
GETDisponibileFRESH

Stato del servizio

Stato complessivo, istanze e archivi dell'API, endpoint con errori, percentili di latenza, disponibilità a 30 giorni, stato di salute dei collector per famiglia di dati e incidenti aperti.

GET/api/meta/status

Richiesta

Questo endpoint non accetta parametri.

Richiesta di esempio

curl -s "https://www.coinboss.com/api/meta/status"

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 (`coinboss.meta.status/1`).
nownumbermsOra del server al momento della composizione della risposta.
overallstring—Stato complessivo del servizio: `operational`, `degraded`, `partial_outage`, `major_outage` o `unknown`; vedere `legend`.
api_versionstring—Versione dell'API pubblica (`v1`).
catalog_versionstring—Versione del catalogo degli endpoint, una data di rilascio come `2026.11.11`.
componentsarray—Componenti del servizio con il relativo stato: API REST, flusso WebSocket, database, cache, archivio delle serie temporali, sonda degli endpoint e raccolta dei dati.
components[]object—Un componente: `id`, `title`, `status` e un oggetto `detail` i cui campi dipendono dal componente.
components[].idstring—Identificatore.
components[].titlestring—Nome visualizzato del componente.
components[].statusstring—Stato.
components[].detailobject—Dettaglio.
components[].detail.instances_healthynumbercountIstanze del server API che hanno appena risposto al controllo di salute. può essere assente
components[].detail.instances_totalnumbercountIstanze del server API sottoposte al controllo. può essere assente
components[].detail.health_latency_msnumbermsRisposta più lenta al controllo di salute tra le istanze dell'API. può essere assente
components[].detail.last_check_atnumbermsTimestamp. può essere assente
components[].detail.first_frame_msnumbermsTempo trascorso dalla connessione al flusso WebSocket all'arrivo del primo frame nell'ultima sonda; null quando non è stato sondato. può essere assente
components[].detail.ping_msnumbermsTempo di andata e ritorno di una query banale verso il componente (database, cache o archivio delle serie temporali), misurato dall'host dell'API. può essere assente
components[].detail.notenull—Nota. può essere assente
components[].detail.last_run_atnumbermsTimestamp. può essere assente
components[].detail.age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga. può essere assente
components[].detail.interval_snumbersIntervallo previsto tra due esecuzioni della sonda (300). può essere assente
components[].detail.took_msnumbermsDurata dell'ultima esecuzione completa della sonda; null quando non è registrata. può essere assente
components[].detail.families_totalnumbercountNumero di famiglie di dati valutate per la raccolta dei dati. può essere assente
components[].detail.families_degradednumbercountNumero di famiglie di dati il cui stato di raccolta è `degraded` o `outage`. può essere assente
components[].detail.judged_bystring—Timestamp in base al quale è stato valutato lo stato. può essere assente
endpointsobject—Numero di endpoint documentati in ciascuno stato in tempo reale, più l'elenco di quelli in errore.
endpoints.totalnumber—Totale.
endpoints.availablenumber—Indica se i dati sono disponibili.
endpoints.partialnumber—true quando è presente solo una parte dei dati attesi.
endpoints.degradednumbercountNumero di endpoint il cui stato in tempo reale è `degraded`.
endpoints.downnumbercountNumero di endpoint il cui stato in tempo reale è `down`.
endpoints.unavailablenumber—Elementi per i quali non sono disponibili dati, con i motivi. Mai riportati come 0.
endpoints.unknownnumbercountNumero di endpoint il cui stato in tempo reale è `unknown` (nessun risultato recente della sonda).
endpoints.failingarray—Endpoint attualmente `down` o `degraded`, ciascuno con `id`, `path`, `status`, `reason`, ultimo stato HTTP, ora dell'ultimo successo e serie di fallimenti.
endpoints.failing[]object—Un endpoint attualmente non raggiungibile o degradato.
endpoints.failing[].idstring—Identificatore.
endpoints.failing[].pathstring—Percorso dell'endpoint.
endpoints.failing[].statusstring—Stato.
endpoints.failing[].reasonstring—Codice del motivo.
endpoints.failing[].httpnumber—Stato HTTP dell'ultima sonda; `null` quando non è mai stato sondato.
endpoints.failing[].last_ok_atnumbermsTimestamp.
endpoints.failing[].fail_streaknumbercountNumero di sonde fallite consecutive.
latency_msobject—Distribuzione dei tempi di risposta dell'ultima chiamata riuscita della sonda per ciascun endpoint, misurata sull'host dell'API.
latency_ms.p50numbermsTempo di risposta mediano tra gli endpoint; null quando non c'è alcun campione aggiornato.
latency_ms.p95numberms95º percentile del tempo di risposta tra gli endpoint; null quando non c'è alcun campione aggiornato.
latency_ms.maxnumber—Massimo.
latency_ms.samplenumbercountNumero di endpoint inclusi nei valori di latenza.
latency_ms.measuredstring—Nota in testo semplice su dove viene misurata la latenza: lato server, escluso il transito di rete.
uptimeobject—Controlli della sonda su tutti gli endpoint nel loro insieme nella finestra: totali, percentuale di successo e ripartizione per giorno.
uptime.window_daysnumberdaysDurata della finestra di disponibilità (30).
uptime.checksnumbercountNumero di controlli della sonda nella finestra, tutti gli endpoint insieme.
uptime.oknumbercountNumero di quei controlli andati a buon fine.
uptime.pctnumber%Percentuale.
uptime.tracking_sincestring—Primo giorno con dati della sonda all'interno della finestra, `YYYY-MM-DD`; null quando non ci sono ancora dati.
uptime.daysarray—Valori giornalieri o numero di giorni.
uptime.days[]object—Valori giornalieri o numero di giorni.
uptime.days[].daystring—Giorno di calendario (UTC).
uptime.days[].checksnumbercountNumero di richieste della sonda in quel giorno.
uptime.days[].oknumbercountNumero di richieste della sonda riuscite in quel giorno.
uptime.days[].pctnumber%Percentuale.
uptime.days[].schema_pctnumber%Quota delle risposte sondate in quel giorno che corrispondevano alla tabella dei campi documentata.
uptime.days[].avg_msnumbermsTempo di risposta medio in quel giorno.
collectorsobject—Stato della raccolta dei dati degli exchange, valutato dai timestamp dei dati in archivio: conteggi per famiglia, controlli sui dataset e stato di salute del controllo periodico; null quando non è valutabile.
collectors.familiesarray—Stato della raccolta per famiglia di dati.
collectors.families[]object—Una famiglia: `family`, `title`, numero di exchange in ciascuno stato e lo `status` risultante.
collectors.families[].familystring—ID della famiglia, per esempio `ticker`, `oi`, `funding`, `liquidation`, `options`.
collectors.families[].titlestring—Titolo visualizzato della famiglia.
collectors.families[].exchanges_collectednumbercountExchange per i quali la famiglia viene raccolta: fresh + partial + stale + broken.
collectors.families[].freshnumbercountExchange i cui dati più recenti per la famiglia rientrano nella finestra di freschezza.
collectors.families[].partialnumber—true quando è presente solo una parte dei dati attesi.
collectors.families[].stalenumber—Righe o flag relativi ai dati più vecchi della finestra di freschezza.
collectors.families[].brokennumbercountExchange la cui fonte a monte continua a fallire o le cui righe non superano per lo più i controlli di plausibilità per la famiglia.
collectors.families[].unavailablenumber—Elementi per i quali non sono disponibili dati, con i motivi. Mai riportati come 0.
collectors.families[].statusstring—Stato.
collectors.datasetsarray—Controlli di qualità dei dataset che non sono per exchange (per esempio i dati giornalieri degli ETF spot e del CME), ciascuno con stato, ritardo, copertura e motivo.
collectors.datasets[]object—Un dataset relativo all'intero mercato e non legato a un singolo exchange (opzioni, ETF spot, CME, book degli ordini, base).
collectors.datasets[].familystring—ID del dataset, per esempio `etf` o `cme`.
collectors.datasets[].idstring—Identificatore.
collectors.datasets[].titlestring—Nome visualizzato del dataset.
collectors.datasets[].sourcestring—Provenienza del valore.
collectors.datasets[].endpointstring—Endpoint pubblico che serve il dataset.
collectors.datasets[].statusstring—Stato.
collectors.datasets[].lag_snumbersEtà del punto dati più recente al momento della generazione della risposta.
collectors.datasets[].source_atnumbermsTimestamp.
collectors.datasets[].fetched_atnumbermsMomento in cui CoinBoss ha recuperato i dati dalla fonte.
collectors.datasets[].fresh_within_snumbersFinestra di freschezza: i dati più recenti di questo valore sono considerati aggiornati.
collectors.datasets[].coverageobject—Che cosa è incluso e che cosa manca.
collectors.datasets[].coverage.funds_totalnumbercountNumero di fondi tracciati. può essere assente
collectors.datasets[].coverage.funds_coverednumbercountNumero di fondi con un'informativa utilizzabile. può essere assente
collectors.datasets[].coverage.funds_unavailablenumbercountNumero di fondi il cui emittente non pubblica alcuna informativa leggibile dalla macchina. può essere assente
collectors.datasets[].coverage.funds_failingnumbercountNumero di fondi la cui informativa non è stata leggibile nell'ultimo ciclo di raccolta. può essere assente
collectors.datasets[].coverage.as_ofstring—Data dell'informativa più recente tra i fondi coperti (YYYY-MM-DD). può essere assente
collectors.datasets[].coverage.as_of_minstring—Data dell'informativa più vecchia tra i fondi coperti (YYYY-MM-DD). può essere assente
collectors.datasets[].reasonstring|null—Codice del motivo.
collectors.datasets[].coverage.contractsnumber—Righe per contratto. può essere assente
collectors.datasets[].coverage.report_datestring—Data del report Commitments of Traders della CFTC più recente (YYYY-MM-DD). può essere assente
collectors.datasets[].coverage.productsnumbercountNumero di prodotti del CME coperti. può essere assente
collectors.datasets[].coverage.trade_datestring—Data di contrattazione del report giornaliero del CME più recente (YYYY-MM-DD). può essere assente
collectors.patrol_okboolean—true quando il controllo periodico della qualità dei dati è stato eseguito negli ultimi 15 minuti.
collectors.patrol_age_snumbersSecondi trascorsi dall'evento.
collectors.evaluated_atnumbermsTimestamp.
incidentsobject—Avvisi sulla qualità dei dati aperti o risolti negli ultimi 7 giorni: numero `open` e `items` (al massimo 100).
incidents.opennumber—Prezzo di apertura del periodo.
incidents.itemsarray—Elementi del risultato.
incidents.items[]object—Elementi del risultato.
incidents.items[].levelstring—Livello.
incidents.items[].exchangestring—ID dell'exchange, in minuscolo (per esempio `binance`).
incidents.items[].familystring—Famiglia di dati a cui si riferisce l'avviso.
incidents.items[].codestring—Codice.
incidents.items[].detailstring—Dettaglio.
incidents.items[].opened_atnumbermsTimestamp.
incidents.items[].last_seen_atnumbermsTimestamp.
incidents.items[].resolved_atnumber|nullmsTimestamp.
incidents.items[].hitsnumbercountNumero di esecuzioni del controllo periodico (una ogni 5 minuti) che hanno osservato la condizione dall'apertura dell'avviso.
incidents.items[].openboolean—Prezzo di apertura del periodo.
probeobject—Stato della sonda degli endpoint alla base degli stati in tempo reale: ora dell'ultima esecuzione, la sua età, l'intervallo e se è aggiornata.
probe.last_run_atnumbermsTimestamp.
probe.age_snumbersSecondi trascorsi dall'ultimo aggiornamento di questa riga.
probe.interval_snumbersIntervallo previsto tra due esecuzioni della sonda (300).
probe.freshboolean—true quando l'ultima esecuzione della sonda risale a meno di 20 minuti fa; quando è false, gli stati degli endpoint sono riportati come `unknown`.
probe.errornull—Messaggio di errore (presente solo in caso di errore).
probe.endpoints_checkednumbercountNumero di endpoint controllati nell'ultimo ciclo della sonda.
probe.oknumbercountNumero di endpoint che hanno risposto correttamente nell'ultimo ciclo della sonda.
probe.failednumbercountNumero di endpoint falliti nell'ultimo ciclo della sonda.
probe.schema_mismatchnumbercountNumero di endpoint la cui risposta non corrispondeva alla tabella dei campi documentata.
probe.alt_samples_failednullcountNumero di richieste campione aggiuntive fallite; `null` quando l'ultimo ciclo non le ha eseguite.
legendobject—Definizione in testo semplice di ogni valore di `overall`.
legend.operationalstring—Definizione di `operational`.
legend.degradedstring—Definizione di `degraded`.
legend.partial_outagestring—Definizione di `partial_outage`.
legend.major_outagestring—Definizione di `major_outage`.
legend.unknownstring—Definizione di `unknown`.
metaobject—Envelope di questa risposta: ID dello schema, sistema di origine, timestamp, durata della cache e freschezza.
meta.schemastring—ID dello schema di questa risposta; stesso valore del campo di primo livello `schema`.
meta.sourcearray—Provenienza del valore.
meta.source[]object—Provenienza del valore.
meta.source[].systemstring—Sistema che ha prodotto i dati; sempre `coinboss` per gli endpoint del centro sviluppatori.
meta.source[].componentstring—Componente alla base dei dati: la sonda degli endpoint e il controllo periodico della qualità dei dati.
meta.observed_atnull—Timestamp.
meta.received_atnumbermsTimestamp.
meta.fetched_atnumbermsMomento in cui CoinBoss ha recuperato i dati dalla fonte.
meta.windowstring—Finestra.
meta.cache_ttl_snumbersDurata della cache lato server di questa risposta.
meta.qualitystring—`FRESH` quando la sonda degli endpoint ha riportato risultati negli ultimi 20 minuti, altrimenti `STALE`.
meta.is_staleboolean—true quando la riga è più vecchia della finestra di freschezza; le righe obsolete non vengono usate nei totali.
meta.fallbackstring—Nota in testo semplice su ciò che questo endpoint restituisce quando i suoi dati di ingresso sono obsoleti o mancanti.

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

Risposta di esempio

/api/meta/status · Risposta reale acquisita 2026-11-13 03:53:47 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: components conteneva 7 elementi; uptime.days conteneva 3 elementi; incidents.items conteneva 11 elementi; endpoints.failing conteneva 25 elementi; collectors.datasets conteneva 12 elementi; collectors.families conteneva 12 elementi.

  • {
    • "success": true,
    • "schema": "coinboss.meta.status/1",
    • "now": 1794542027137,
    • "overall": "partial_outage",
    • "api_version": "v1",
    • "catalog_version": "2026.11.12",
    • "components": [
      • { … 4 },
      • { … 4 }
      ],
    • "endpoints": {
      • "total": 299,
      • "available": 256,
      • "partial": 17,
      • "degraded": 17,
      • "down": 8,
      • "unavailable": 1,
      • "unknown": 0,
      • "failing": [ … 2 ]
      },
    • "latency_ms": {
      • "p50": 7,
      • "p95": 839,
      • "max": 10047,
      • "sample": 289,
      • "measured": "server-side, from the probe on the API host (excludes network transit)"
      },
    • "uptime": {
      • "window_days": 30,
      • "checks": 119504,
      • "ok": 118277,
      • "pct": 98.97,
      • "tracking_since": "2026-11-11",
      • "days": [ … 2 ]
      },
    • "collectors": {
      • "families": [ … 2 ],
      • "datasets": [ … 2 ],
      • "patrol_ok": true,
      • "patrol_age_s": 282,
      • "evaluated_at": 1794542027976
      },
    • "incidents": {
      • "open": 2,
      • "items": [ … 2 ]
      },
    • "probe": {
      • "last_run_at": 1794541726312,
      • "age_s": 301,
      • "interval_s": 300,
      • "fresh": true,
      • "error": null,
      • "endpoints_checked": 290,
      • "ok": 289,
      • "failed": 1,
      • "schema_mismatch": 0,
      • "alt_samples_failed": null
      },
    • "legend": {
      • "operational": "all checks pass",
      • "degraded": "serving, with stale data, schema drift or reduced redundancy",
      • "partial_outage": "at least one endpoint or API instance is failing",
      • "major_outage": "database down, no API instance healthy, or 20%+ of endpoints failing",
      • "unknown": "the probe has not reported within 20 minutes — status cannot be asserted"
      },
    • "meta": {
      • "schema": "coinboss.meta.status/1",
      • "source": [ … 1 ],
      • "observed_at": null,
      • "received_at": 1794541726312,
      • "fetched_at": 1794542027137,
      • "window": "latest",
      • "cache_ttl_s": 15,
      • "quality": "FRESH",
      • "is_stale": false,
      • "fallback": "status is \"unknown\" whenever the probe is stale; process liveness is never used as evidence"
      }
    }

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
15s
Micro-cache edge
10s
Frequenza di aggiornamento
Valutato su richiesta; i risultati degli endpoint provengono dalla sonda dell'API eseguita ogni 5 minuti, la salute dei collector dai timestamp dei dati.
Fonti dei dati
Risultati della sonda dell'API, controlli di salute per istanza, matrice della qualità dei dati, log degli avvisi.
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

DisponibileVerificato 2026-11-13 03:53:47 UTCHTTP 200872 msSchema conformeDato più recente risalente a 5m fa

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 →

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/meta/statusDisponibile
Parametri

Nessun parametro.

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