Système et métadonnées

#Santé du service

La sonde. Elle dit si le service est en marche et si sa base de données répond. C’est la seule route qui répond sans clé, et elle n’est jamais décomptée du quota, ce qui en fait le point qu’un système de supervision peut interroger sans rien consommer.

{
  "status": "ok",
  "server_time": "2026-11-08T12:51:13.156Z",
  "data_type": "health",
  "data": {
    "database": "connected"
  }
}

En cas de problème : 503 avec le corps d’erreur (error.code: "service_unavailable", et database: "unreachable", service et retry_after_s sous error.details), et l’en-tête Retry-After.

#Fraîcheur des flux

Une ligne par flux de données, sous son nom public : son âge, le rythme auquel il doit publier, et un drapeau is_stale calculé côté serveur. La règle est la même pour tous les flux : un flux est en retard quand il n’a rien livré depuis 1,5 × son rythme attendu. Aucune table interne, aucun nom de place, aucun compte de lignes. C’est la route à interroger avant de construire une analyse : savoir qu’une donnée est ancienne vaut mieux que de le découvrir dans un résultat. Elle couvre toutes les familles : prix et volumes, dérivés, flux d’ordres, transactions, mais aussi options, on-chain, macro, ETF, tokenomics et sentiment. Une série lente n’est pas une série en retard : une série macro mensuelle ou un dépôt ETF trimestriel atteint légitimement un âge de plusieurs semaines, et son expected_interval_s le dit.

{
  "status": "ok",
  "server_time": "2026-11-08T12:51:14.698Z",
  "data_type": "status",
  "data": {
    "computed_at": "2026-11-08T12:51:13.669Z",
    "state": "ok",
    "feed_count": 82,
    "stale_feed_count": 0,
    "error_feed_count": 0,
    "max_age_s": 7649473.7,
    "feeds": [
      {
        "feed": "klines_futures_1m",
        "family": "price_volume",
        "routes": [
          "/v1/klines",
          "/v1/klines/history"
        ],
        "age_s": 73.7,
        "expected_interval_s": 120,
        "threshold_s": 180,
        "is_stale": false,
        "stale_venue_count": 0
      },
      {
        "feed": "klines_1m",
        "family": "price_volume",
        "routes": [
          "/v1/klines",
          "/v1/klines/history"
        ],
        "age_s": 73.7,
        "expected_interval_s": 180,
        "threshold_s": 270,
        "is_stale": false,
        "stale_venue_count": 0
      },
      {
        "feed": "klines_multi",
        "family": "price_volume",
        "routes": [
          "/v1/klines",
          "/v1/klines/history"
        ],
        "age_s": 373.7,
        "expected_interval_s": 660,
        "threshold_s": 990,
        "is_stale": false,
        "stale_venue_count": null
      }
    ]
  }
}

#Catalogue des symboles

La liste vivante des actifs activés. C’est elle qui fait foi : ne codez pas la liste en dur dans un client, faites-la lire au démarrage.

{
  "status": "ok",
  "server_time": "2026-11-08T12:51:15.750Z",
  "data_type": "symbols",
  "data": [
    {
      "symbol": "AAVEUSDT",
      "base_asset": "AAVE",
      "name": "Aave",
      "quote_asset": "USDT",
      "markets": [
        "spot",
        "futures"
      ]
    },
    {
      "symbol": "ADAUSDT",
      "base_asset": "ADA",
      "name": "Cardano",
      "quote_asset": "USDT",
      "markets": [
        "spot",
        "futures"
      ]
    }
  ]
}

#Rapport de capacités

Ce que cet actif peut réellement servir, mesuré sur les dernières vingt-quatre heures. Il permet d’anticiper une réponse vide au lieu de la découvrir, et de distinguer une métrique qui n’a pas de sens ici d’une métrique momentanément bloquée.

curl -H "X-API-KEY: $BYTNODE_API_KEY"   "https://api.bytnode.com/v1/capabilities?symbol=BTCUSDT"

Un symbole inconnu ou désactivé renvoie 422 invalid_symbol avec la liste des symboles actifs.

#Les limites de votre offre

Ce que votre clé peut faire, lu dans l’offre qui a servi CETTE requête : les familles de données de marché incluses, la fenêtre d’historique de chaque unité de temps, la fenêtre tick par tick, le nombre de liquidations individuelles, et le débit par minute et le quota mensuel avec ce qu’il en reste. Dimensionnez limit et since_ms à partir d’elle avant de paginer, au lieu de découvrir la fenêtre par un 403 history_depth. Non décomptée de votre quota. Avec une clé non comptée, chaque limite vaut null.

curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/limits"