Sistema y metadatos

#Salud del servicio

La sonda. Dice si el servicio está en marcha y si su base de datos responde. Es la única ruta que responde sin clave y nunca se descuenta de la cuota, lo que la convierte en el punto que un sistema de monitorización puede consultar sin consumir nada.

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

En caso de problema: 503 con el cuerpo de error (error.code: "service_unavailable", y database: "unreachable", service y retry_after_s bajo error.details), y la cabecera Retry-After.

#Frescura de los flujos

Una línea por flujo de datos, con su nombre público: su antigüedad, el ritmo al que debe publicar y un indicador is_stale calculado en el servidor. La regla es la misma para todos los flujos: un flujo va con retraso cuando no ha entregado nada desde hace 1,5 × su ritmo esperado. Ninguna tabla interna, ningún nombre de mercado, ningún recuento de filas. Es la ruta que hay que consultar antes de construir un análisis: saber que un dato es antiguo es mejor que descubrirlo en un resultado. Cubre todas las familias: precios y volúmenes, derivados, flujo de órdenes, operaciones, y también opciones, on-chain, macro, ETF, tokenomics y sentimiento. Una serie lenta no es una serie con retraso: una serie macro mensual o un informe ETF trimestral alcanza legítimamente una antigüedad de semanas, y su expected_interval_s lo indica.

{
  "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
      }
    ]
  }
}

#Catálogo de símbolos

La lista viva de los activos habilitados. Es la referencia: no codifiques la lista en un cliente, haz que la lea al arrancar.

{
  "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"
      ]
    }
  ]
}

#Informe de capacidades

Lo que este activo puede servir realmente, medido en las últimas veinticuatro horas. Permite anticipar una respuesta vacía en lugar de descubrirla, y distinguir una métrica que no tiene sentido aquí de una métrica bloqueada momentáneamente.

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

Un símbolo desconocido o desactivado devuelve 422 invalid_symbol con la lista de símbolos activos.

#Los límites de tu plan

Lo que puede hacer tu clave, leído del plan que sirvió ESTA petición: las familias de datos de mercado incluidas, la ventana de historial de cada temporalidad, la ventana tick a tick, el número de liquidaciones individuales, y la velocidad por minuto y la cuota mensual con lo que queda. Dimensiona limit y since_ms a partir de ella antes de paginar, en lugar de descubrir la ventana con un 403 history_depth. No se descuenta de tu cuota. Con una clave no contabilizada, cada límite vale null.

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