API de indicadores cripto

#Indicadores técnicos para agentes de IA: tool calling

«¿Está BTC sobrecomprado en el RSI de 4 horas?», «¿Ha cruzado el MACD de ETH su línea de señal?», «Compara el ADX de SOL y AVAX»: el agente de IA describe el cálculo y la herramienta MCP get_market_indicators lo ejecuta, en hasta diez pares. Es el tool calling en su forma más simple.

{
  "name": "get_market_indicators",
  "arguments": {
    "symbol": "BTCUSDT",
    "timeframe": "4h",
    "limit": 1,
    "indicators": [
      { "id": "rsi_14", "type": "rsi", "period": 14 },
      { "id": "macd", "type": "macd", "fast": 12, "slow": 26, "signal": 9 }
    ]
  }
}

• Para el LLM: los valores llegan del más reciente al más antiguo y se calculan solo con velas cerradas: la vela en curso nunca mueve un indicador.
• Para desarrolladores: POST /v1/indicators recibe la misma descripción como cuerpo JSON, lo que la convierte en una herramienta lista para tu propio agente de IA; los diecinueve tipos y sus parámetros figuran más abajo.
• Dónde funciona: Claude, ChatGPT, Cursor y cualquier cliente MCP, incluidos los frameworks de agentes compatibles con MCP, como LangChain o n8n.

Conecta tu agente de IA con la guía del servidor MCP, o enséñale BytNode con los Agent Skills de código abierto.

#La llamada

El único endpoint que recibe un cuerpo JSON: describe un cálculo, no una lectura. Los valores no se almacenan ni se guardan en caché. Se producen en cada llamada a partir de las velas cerradas.

curl -X POST "https://api.bytnode.com/v1/indicators" \
  -H "X-API-KEY: $BYTNODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTCUSDT",
    "timeframe": "1h",
    "limit": 3,
    "indicators": [
      { "id": "rsi_14", "type": "rsi", "period": 14 },
      { "id": "macd", "type": "macd", "fast": 12, "slow": 26, "signal": 9 },
      { "id": "bb_20", "type": "bb", "period": 20 }
    ]
  }'

1m5m15m30m1h4h1d1w

#Los diecinueve indicadores

#Los identificadores

Cada instancia lleva un id que eliges tú: es la clave de su resultado en la respuesta. Cualquier nombre de 1 a 64 caracteres entre letras, cifras, _, - y ., único en la llamada: rsi_7, rsi_21, tendencia.ema_200.

Un tipo puede aparecer tantas veces como haga falta, dentro del límite de cincuenta indicadores por llamada: cinco medias móviles de periodos distintos, o tres RSI, uno al lado del otro.

rsiemasmabbatrstochmacdobvadxsarcciwillrmfirocadadosckeltnerdonchianichimoku

Un identificador ausente, mal formado o duplicado devuelve 422 invalid_indicator.

#La regla del límite

Un indicador necesita un warm-up (velas anteriores al primer valor publicable). La regla es:

limit + warmup(type, parameters) <= 1000

Más allá, la petición devuelve 422. En los tipos con calentamiento lineal, el mensaje indica el periodo máximo utilizable para el limit pedido.

#La respuesta

{
  "status": "ok",
  "server_time": "2026-11-08T12:52:44.953Z",
  "data_type": "indicators",
  "symbol": "BTCUSDT",
  "timeframe": "1h",
  "data": {
    "indicators": {
      "rsi_14": {
        "type": "rsi",
        "period": 14,
        "values": [
          {
            "time": "2026-11-08T11:00:00.000Z",
            "value": 54.072013544
          },
          {
            "time": "2026-11-08T10:00:00.000Z",
            "value": 49.3688670483
          },
          {
            "time": "2026-11-08T09:00:00.000Z",
            "value": 51.577078526
          }
        ]
      },
      "macd": {
        "type": "macd",
        "fast": 12,
        "slow": 26,
        "signal": 9,
        "values": [
          {
            "time": "2026-11-08T11:00:00.000Z",
            "macd": -14.2249104846,
            "signal": -45.998361242,
            "histogram": 31.7734507574
          },
          {
            "time": "2026-11-08T10:00:00.000Z",
            "macd": -24.0339550779,
            "signal": -53.9417239313,
            "histogram": 29.9077688534
          },
          {
            "time": "2026-11-08T09:00:00.000Z",
            "macd": -27.3827508304,
            "signal": -61.4186661447,
            "histogram": 34.0359153142
          }
        ]
      },
      "bb_20": {
        "type": "bb",
        "period": 20,
        "std": 2,
        "values": [
          {
            "time": "2026-11-08T11:00:00.000Z",
            "upper": 75998.1649923,
            "middle": 75839.8095,
            "lower": 75681.4540077
          },
          {
            "time": "2026-11-08T10:00:00.000Z",
            "upper": 75976.7264653,
            "middle": 75828.6555,
            "lower": 75680.5845347
          },
          {
            "time": "2026-11-08T09:00:00.000Z",
            "upper": 75985.9705718,
            "middle": 75831.36,
            "lower": 75676.7494282
          }
        ]
      }
    }
  }
}

• Las claves de data.indicators son tus identificadores.
• Cada entrada repite su type y sus parámetros efectivos, con los valores por defecto completados: siempre sabes lo que se calculó.
• values es una lista de filas fechadas, de la más reciente a la más antigua como toda lista de BytNode: cada fila es {time, value}, o time y las salidas con nombre de un indicador de varias salidas (macd, signal, histogram; upper, middle, lower…). time es el inicio de la vela de esa fila.
• Un valor indefinido sale como null, nunca como NaN.
• Las salidas con varias claves siguen el orden declarado por el tipo, no el del motor de cálculo.

#Diferencias de convención

Estas diferencias provienen de mediciones, no de preferencias. Conocerlas evita buscar un fallo donde no lo hay.

#Errores

El orden de validación es fijo: temporalidad, después limit, después símbolo, después análisis de los indicadores, después la regla del límite y después la lectura de las velas. Gana el primer fallo.