/api/meta/status
GETDisponibleFRESH

Statut du service

Statut global, instances de l'API et stockages, endpoints en échec, centiles de latence, disponibilité sur 30 jours, santé des collecteurs par famille de données et incidents ouverts.

GET/api/meta/status

Requête

Cet endpoint n'accepte aucun paramètre.

Exemple de requête

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

Champs de la réponse

Le tableau des champs est généré à partir de réponses réelles : il liste donc exactement ce que renvoie l'endpoint. Les chemins utilisent a[] pour les éléments d'un tableau et {*} pour les objets indexés par un nom dynamique, comme une crypto ou une plateforme.

ChampTypeUnitéDescription
successboolean—true lorsque la requête a abouti. En cas d'échec, le corps est `{ success: false, code, error, request_id }`.
schemastring—Identifiant du schéma de cette réponse (`coinboss.meta.status/1`).
nownumbermsHeure du serveur au moment où la réponse a été construite.
overallstring—Statut global du service : `operational`, `degraded`, `partial_outage`, `major_outage` ou `unknown` ; voir `legend`.
api_versionstring—Version de l'API publique (`v1`).
catalog_versionstring—Version du catalogue des endpoints, une date de publication telle que `2026.11.11`.
componentsarray—Composants du service avec leur statut : API REST, flux WebSocket, base de données, cache, stockage de séries temporelles, sonde des endpoints et collecte des données.
components[]object—Un composant : `id`, `title`, `status` et un objet `detail` dont les champs dépendent du composant.
components[].idstring—Identifiant.
components[].titlestring—Nom d'affichage du composant.
components[].statusstring—Statut.
components[].detailobject—Détail.
components[].detail.instances_healthynumbercountInstances du serveur d'API ayant répondu à l'instant au contrôle de santé. peut être absent
components[].detail.instances_totalnumbercountInstances du serveur d'API qui ont été contrôlées. peut être absent
components[].detail.health_latency_msnumbermsRéponse la plus lente au contrôle de santé parmi les instances de l'API. peut être absent
components[].detail.last_check_atnumbermsHorodatage. peut être absent
components[].detail.first_frame_msnumbermsDélai entre la connexion au flux WebSocket et l'arrivée de la première trame lors de la dernière sonde ; null lorsqu'il n'a pas été sondé. peut être absent
components[].detail.ping_msnumbermsTemps d'aller-retour d'une requête triviale vers le composant (base de données, cache ou stockage de séries temporelles), mesuré depuis l'hôte de l'API. peut être absent
components[].detail.notenull—Remarque. peut être absent
components[].detail.last_run_atnumbermsHorodatage. peut être absent
components[].detail.age_snumbersSecondes écoulées depuis la dernière mise à jour de cette ligne. peut être absent
components[].detail.interval_snumbersIntervalle prévu entre deux exécutions de la sonde (300). peut être absent
components[].detail.took_msnumbermsDurée de la dernière exécution complète de la sonde ; null lorsqu'elle n'est pas enregistrée. peut être absent
components[].detail.families_totalnumbercountNombre de familles de données évaluées pour la collecte des données. peut être absent
components[].detail.families_degradednumbercountNombre de familles de données dont le statut de collecte est `degraded` ou `outage`. peut être absent
components[].detail.judged_bystring—Horodatage à partir duquel le statut a été évalué. peut être absent
endpointsobject—Nombre d'endpoints documentés dans chaque statut en direct, ainsi que la liste de ceux en échec.
endpoints.totalnumber—Total.
endpoints.availablenumber—Indique si des données sont disponibles.
endpoints.partialnumber—true lorsque seule une partie des données attendues est présente.
endpoints.degradednumbercountNombre d'endpoints dont le statut en direct est `degraded`.
endpoints.downnumbercountNombre d'endpoints dont le statut en direct est `down`.
endpoints.unavailablenumber—Éléments pour lesquels aucune donnée n'est disponible, avec les raisons. Jamais déclarés comme 0.
endpoints.unknownnumbercountNombre d'endpoints dont le statut en direct est `unknown` (aucun résultat de sonde récent).
endpoints.failingarray—Endpoints actuellement `down` ou `degraded`, chacun avec `id`, `path`, `status`, `reason`, le dernier statut HTTP, l'heure du dernier succès et la série d'échecs.
endpoints.failing[]object—Un endpoint actuellement hors service ou dégradé.
endpoints.failing[].idstring—Identifiant.
endpoints.failing[].pathstring—Chemin de l'endpoint.
endpoints.failing[].statusstring—Statut.
endpoints.failing[].reasonstring—Code de raison.
endpoints.failing[].httpnumber—Statut HTTP de la dernière sonde ; `null` s'il n'a jamais été sondé.
endpoints.failing[].last_ok_atnumbermsHorodatage.
endpoints.failing[].fail_streaknumbercountNombre de sondes en échec consécutives.
latency_msobject—Distribution des temps de réponse du dernier appel de sonde réussi de chaque endpoint, mesurée sur l'hôte de l'API.
latency_ms.p50numbermsTemps de réponse médian sur l'ensemble des endpoints ; null en l'absence d'échantillon à jour.
latency_ms.p95numbermsTemps de réponse au 95e centile sur l'ensemble des endpoints ; null en l'absence d'échantillon à jour.
latency_ms.maxnumber—Maximum.
latency_ms.samplenumbercountNombre d'endpoints pris en compte dans les chiffres de latence.
latency_ms.measuredstring—Note en texte brut sur l'endroit où la latence est mesurée : côté serveur, hors transit réseau.
uptimeobject—Contrôles de la sonde sur l'ensemble des endpoints au cours de la fenêtre : totaux, pourcentage de réussite et détail par jour.
uptime.window_daysnumberdaysDurée de la fenêtre de disponibilité (30).
uptime.checksnumbercountNombre de contrôles de la sonde dans la fenêtre, tous endpoints confondus.
uptime.oknumbercountNombre de ces contrôles ayant réussi.
uptime.pctnumber%Pourcentage.
uptime.tracking_sincestring—Premier jour disposant de données de sonde dans la fenêtre, `YYYY-MM-DD` ; null tant qu'il n'y a pas encore de données.
uptime.daysarray—Valeurs quotidiennes ou nombre de jours.
uptime.days[]object—Valeurs quotidiennes ou nombre de jours.
uptime.days[].daystring—Jour calendaire (UTC).
uptime.days[].checksnumbercountNombre de requêtes de sonde ce jour-là.
uptime.days[].oknumbercountNombre de requêtes de sonde réussies ce jour-là.
uptime.days[].pctnumber%Pourcentage.
uptime.days[].schema_pctnumber%Part des réponses sondées ce jour-là qui correspondaient à la table des champs documentée.
uptime.days[].avg_msnumbermsTemps de réponse moyen ce jour-là.
collectorsobject—État de la collecte des données des plateformes, évalué à partir des horodatages des données stockées : décomptes par famille, contrôles des jeux de données et santé de la patrouille ; null lorsqu'il ne peut pas être évalué.
collectors.familiesarray—Statut de collecte par famille de données.
collectors.families[]object—Une famille : `family`, `title`, le nombre de plateformes dans chaque état et le `status` qui en résulte.
collectors.families[].familystring—Identifiant de la famille, par exemple `ticker`, `oi`, `funding`, `liquidation`, `options`.
collectors.families[].titlestring—Titre d'affichage de la famille.
collectors.families[].exchanges_collectednumbercountPlateformes pour lesquelles la famille est collectée : fresh + partial + stale + broken.
collectors.families[].freshnumbercountPlateformes dont la donnée la plus récente pour la famille se situe dans la fenêtre de fraîcheur.
collectors.families[].partialnumber—true lorsque seule une partie des données attendues est présente.
collectors.families[].stalenumber—Lignes ou indicateur signalant des données plus anciennes que la fenêtre de fraîcheur.
collectors.families[].brokennumbercountPlateformes dont l'amont échoue de façon répétée ou dont les lignes échouent pour la plupart aux contrôles de cohérence pour la famille.
collectors.families[].unavailablenumber—Éléments pour lesquels aucune donnée n'est disponible, avec les raisons. Jamais déclarés comme 0.
collectors.families[].statusstring—Statut.
collectors.datasetsarray—Contrôles qualité des jeux de données qui ne sont pas établis par plateforme (par exemple les données quotidiennes des ETF spot et du CME), chacun avec son statut, son retard, sa couverture et sa raison.
collectors.datasets[]object—Un jeu de données à l'échelle du marché, non rattaché à une plateforme unique (options, ETF spot, CME, carnets d'ordres, basis).
collectors.datasets[].familystring—Identifiant du jeu de données, par exemple `etf` ou `cme`.
collectors.datasets[].idstring—Identifiant.
collectors.datasets[].titlestring—Nom d'affichage du jeu de données.
collectors.datasets[].sourcestring—Provenance de la valeur.
collectors.datasets[].endpointstring—Endpoint public qui sert le jeu de données.
collectors.datasets[].statusstring—Statut.
collectors.datasets[].lag_snumbersÂge du point de données le plus récent au moment où la réponse a été construite.
collectors.datasets[].source_atnumbermsHorodatage.
collectors.datasets[].fetched_atnumbermsMoment où CoinBoss a récupéré les données auprès de la source.
collectors.datasets[].fresh_within_snumbersFenêtre de fraîcheur : les données plus récentes que ce seuil sont considérées comme à jour.
collectors.datasets[].coverageobject—Ce qui est inclus et ce qui manque.
collectors.datasets[].coverage.funds_totalnumbercountNombre de fonds suivis. peut être absent
collectors.datasets[].coverage.funds_coverednumbercountNombre de fonds disposant d'une publication exploitable. peut être absent
collectors.datasets[].coverage.funds_unavailablenumbercountNombre de fonds dont l'émetteur ne publie aucune information lisible par machine. peut être absent
collectors.datasets[].coverage.funds_failingnumbercountNombre de fonds dont la publication n'a pas pu être lue lors du dernier cycle de collecte. peut être absent
collectors.datasets[].coverage.as_ofstring—Date de publication la plus récente parmi les fonds couverts (YYYY-MM-DD). peut être absent
collectors.datasets[].coverage.as_of_minstring—Date de publication la plus ancienne parmi les fonds couverts (YYYY-MM-DD). peut être absent
collectors.datasets[].reasonstring|null—Code de raison.
collectors.datasets[].coverage.contractsnumber—Lignes par contrat. peut être absent
collectors.datasets[].coverage.report_datestring—Date du rapport Commitments of Traders de la CFTC le plus récent (YYYY-MM-DD). peut être absent
collectors.datasets[].coverage.productsnumbercountNombre de produits CME couverts. peut être absent
collectors.datasets[].coverage.trade_datestring—Date de négociation du rapport quotidien du CME le plus récent (YYYY-MM-DD). peut être absent
collectors.patrol_okboolean—true lorsque la patrouille qualité des données est passée au cours des 15 dernières minutes.
collectors.patrol_age_snumbersSecondes écoulées depuis l'événement.
collectors.evaluated_atnumbermsHorodatage.
incidentsobject—Alertes de qualité des données qui sont ouvertes ou ont été résolues au cours des 7 derniers jours : nombre `open` et `items` (100 au plus).
incidents.opennumber—Prix d'ouverture de la période.
incidents.itemsarray—Éléments du résultat.
incidents.items[]object—Éléments du résultat.
incidents.items[].levelstring—Niveau.
incidents.items[].exchangestring—Identifiant de la plateforme, en minuscules (par exemple `binance`).
incidents.items[].familystring—Famille de données concernée par l'alerte.
incidents.items[].codestring—Code.
incidents.items[].detailstring—Détail.
incidents.items[].opened_atnumbermsHorodatage.
incidents.items[].last_seen_atnumbermsHorodatage.
incidents.items[].resolved_atnumber|nullmsHorodatage.
incidents.items[].hitsnumbercountNombre de passages de la patrouille (un toutes les 5 minutes) ayant observé la condition depuis l'ouverture de l'alerte.
incidents.items[].openboolean—Prix d'ouverture de la période.
probeobject—État de la sonde des endpoints à l'origine des statuts en direct : heure de la dernière exécution, son âge, l'intervalle et le fait qu'elle soit à jour ou non.
probe.last_run_atnumbermsHorodatage.
probe.age_snumbersSecondes écoulées depuis la dernière mise à jour de cette ligne.
probe.interval_snumbersIntervalle prévu entre deux exécutions de la sonde (300).
probe.freshboolean—true lorsque la dernière exécution de la sonde date de moins de 20 minutes ; lorsqu'il vaut false, les statuts des endpoints sont indiqués comme `unknown`.
probe.errornull—Message d'erreur (présent uniquement en cas d'échec).
probe.endpoints_checkednumbercountNombre d'endpoints contrôlés lors du dernier cycle de sonde.
probe.oknumbercountNombre d'endpoints ayant répondu correctement lors du dernier cycle de sonde.
probe.failednumbercountNombre d'endpoints en échec lors du dernier cycle de sonde.
probe.schema_mismatchnumbercountNombre d'endpoints dont la réponse ne correspondait pas à la table des champs documentée.
probe.alt_samples_failednullcountNombre de requêtes d'échantillonnage supplémentaires en échec ; `null` lorsque le dernier cycle ne les a pas exécutées.
legendobject—Définition en texte brut de chaque valeur de `overall`.
legend.operationalstring—Définition de `operational`.
legend.degradedstring—Définition de `degraded`.
legend.partial_outagestring—Définition de `partial_outage`.
legend.major_outagestring—Définition de `major_outage`.
legend.unknownstring—Définition de `unknown`.
metaobject—Enveloppe de cette réponse : identifiant du schéma, système producteur, horodatages, durée de vie du cache et fraîcheur.
meta.schemastring—Identifiant du schéma de cette réponse ; même valeur que le `schema` de premier niveau.
meta.sourcearray—Provenance de la valeur.
meta.source[]object—Provenance de la valeur.
meta.source[].systemstring—Système qui a produit les données ; toujours `coinboss` pour les endpoints du centre développeurs.
meta.source[].componentstring—Composant à l'origine des données : la sonde des endpoints et la patrouille qualité des données.
meta.observed_atnull—Horodatage.
meta.received_atnumbermsHorodatage.
meta.fetched_atnumbermsMoment où CoinBoss a récupéré les données auprès de la source.
meta.windowstring—Fenêtre.
meta.cache_ttl_snumbersDurée de vie du cache côté serveur de cette réponse.
meta.qualitystring—`FRESH` lorsque la sonde des endpoints a rendu compte au cours des 20 dernières minutes, sinon `STALE`.
meta.is_staleboolean—true lorsque la ligne est plus ancienne que la fenêtre de fraîcheur ; les lignes périmées ne sont pas utilisées dans les totaux.
meta.fallbackstring—Note en texte brut sur ce que renvoie cet endpoint lorsque ses données d'entrée sont périmées ou manquantes.

Généré à partir de 1 réponses réelles (2026-11-11 23:01 UTC).

Exemple de réponse

/api/meta/status · Réponse réelle (capture : 2026-11-13 03:59:29 UTC). Les tableaux et dictionnaires longs sont abrégés pour l'affichage : components comptait 7 éléments; uptime.days comptait 3 éléments; incidents.items comptait 11 éléments; endpoints.failing comptait 23 éléments; collectors.datasets comptait 12 éléments; collectors.families comptait 12 éléments.

  • {
    • "success": true,
    • "schema": "coinboss.meta.status/1",
    • "now": 1794542369932,
    • "overall": "partial_outage",
    • "api_version": "v1",
    • "catalog_version": "2026.11.12",
    • "components": [
      • { … 4 },
      • { … 4 }
      ],
    • "endpoints": {
      • "total": 299,
      • "available": 256,
      • "partial": 19,
      • "degraded": 17,
      • "down": 6,
      • "unavailable": 1,
      • "unknown": 0,
      • "failing": [ … 2 ]
      },
    • "latency_ms": {
      • "p50": 6,
      • "p95": 872,
      • "max": 10538,
      • "sample": 292,
      • "measured": "server-side, from the probe on the API host (excludes network transit)"
      },
    • "uptime": {
      • "window_days": 30,
      • "checks": 119803,
      • "ok": 118569,
      • "pct": 98.97,
      • "tracking_since": "2026-11-11",
      • "days": [ … 2 ]
      },
    • "collectors": {
      • "families": [ … 2 ],
      • "datasets": [ … 2 ],
      • "patrol_ok": true,
      • "patrol_age_s": 23,
      • "evaluated_at": 1794542370810
      },
    • "incidents": {
      • "open": 2,
      • "items": [ … 2 ]
      },
    • "probe": {
      • "last_run_at": 1794542029183,
      • "age_s": 341,
      • "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": 1794542029183,
      • "fetched_at": 1794542369932,
      • "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"
      }
    }

Détails

Authentification
Aucune. Endpoint public.
Limite de requêtes
1200 requêtes par minute et par IP
Cache serveur
15s
Micro-cache en périphérie
10s
Fréquence de mise à jour
Évalué à la demande ; les résultats des endpoints proviennent de la sonde d'API exécutée toutes les 5 minutes, la santé des collecteurs des horodatages des données.
Sources de données
Résultats de la sonde d'API, contrôles de santé par instance, matrice de qualité des données, journal des alertes.
Horodatages
Millisecondes depuis l'epoch Unix (UTC), sauf indication contraire dans la description du champ
Format de réponse
json
Stabilité
Stable
Disponible depuis
2026-11-11

Statut en direct

DisponibleVérifié : 2026-11-13 03:59:29 UTCHTTP 200909 msSchéma conformePoint de données le plus récent : il y a 6m

Disponibilité, 30 derniers jours

99.75 % des 408 contrôles réussis

Erreurs

Les appels en échec ont la même structure sur tous les endpoints. La liste complète figure sur la page des erreurs. Erreurs et limites de requêtes →

CodeHTTPSignificationQue faire
INVALID_PARAM400Un paramètre requis est manquant ou une valeur n'est pas acceptée. `param` indique le nom du paramètre lorsqu'il est connu.Ne réessayez pas à l'identique ; corrigez la requête.
UNAUTHORIZED401L'en-tête `CB-API-KEY` a été envoyé, mais la clé est inconnue ou révoquée. Les données publiques ne nécessitent aucune clé — supprimez l'en-tête ou utilisez une clé valide.Ne réessayez pas à l'identique.
FORBIDDEN403La route ne fait pas partie de l'API publique (interne ou réservée aux comptes).Ne réessayez pas.
NOT_FOUND404Route inconnue, ou la crypto / la plateforme / le fonds demandé n'existe pas.Ne réessayez pas ; vérifiez le chemin et les identifiants dans le catalogue.
RATE_LIMITED429Plus de requêtes que la limite par minute. `Retry-After` indique le nombre de secondes à attendre.Attendez la durée indiquée par `Retry-After`, puis réessayez avec backoff.
INTERNAL500Erreur serveur inattendue. Le message est volontairement générique ; citez `request_id` lorsque vous la signalez.Réessayez une fois après quelques secondes ; si l'erreur persiste, signalez-la avec l'ID de requête.
UPSTREAM_FAILED503La source de données derrière cet endpoint n'a pas répondu à temps. Aucun chiffre périmé ni de substitution n'est renvoyé à sa place.Réessayez avec backoff ; consultez la page de statut.
UNAVAILABLE501 / 503Le jeu de données n'est temporairement pas prêt (préchauffage du cache) ou l'endpoint n'a pas encore de source publique licite.Réessayez plus tard ; le catalogue signale les endpoints indisponibles par conception.
REQUEST_FAILED200Certains endpoints plus anciens répondent HTTP 200 avec `success: false`. Vérifiez toujours `success`, et pas seulement le statut HTTP.Dépend du message ; à traiter comme une requête en échec.

Essayer

GET/api/meta/statusDisponible
Paramètres

Aucun paramètre.

URL de la requêtehttps://www.coinboss.com/api/meta/status
Choisissez un endpoint et cliquez sur « Envoyer la requête ». La réponse, les en-têtes et le temps de réponse s'afficheront ici.