API d’indicateurs crypto

#Indicateurs techniques pour agents IA : le tool calling

« BTC est-il suracheté sur le RSI 4 heures ? », « Le MACD d’ETH a-t-il croisé sa ligne de signal ? », « Compare l’ADX de SOL et d’AVAX » : l’agent IA décrit le calcul et l’outil MCP get_market_indicators l’exécute, sur dix paires au plus. C’est le tool calling dans sa forme la plus 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 }
    ]
  }
}

• Pour le LLM : les valeurs arrivent de la plus récente à la plus ancienne et sont calculées sur les seules bougies closes : la bougie en cours ne fait jamais bouger un indicateur.
• Pour les développeurs : POST /v1/indicators prend la même description en corps JSON, ce qui en fait un outil tout prêt pour votre propre agent IA ; les dix-neuf types et leurs paramètres sont listés plus bas.
• Où ça tourne : Claude, ChatGPT, Cursor et tout client MCP, y compris les frameworks d’agents qui parlent MCP, comme LangChain ou n8n.

Branchez votre agent IA avec le guide du serveur MCP, ou apprenez-lui BytNode avec les Agent Skills open source.

#L’appel

Le seul endpoint à prendre un corps JSON : il décrit un calcul, pas une lecture. Les valeurs ne sont ni stockées ni mises en cache. Elles sont produites à chaque appel à partir des bougies closes.

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

#Les dix-neuf indicateurs

#Les identifiants

Chaque instance porte un id que vous choisissez : c’est la clé de son résultat dans la réponse. N’importe quel nom de 1 à 64 caractères parmi lettres, chiffres, _, - et ., unique dans l’appel : rsi_7, rsi_21, tendance.ema_200.

Un type peut apparaître autant de fois que nécessaire, dans la limite de cinquante indicateurs par appel : cinq moyennes mobiles de périodes différentes, ou trois RSI, côte à côte.

rsiemasmabbatrstochmacdobvadxsarcciwillrmfirocadadosckeltnerdonchianichimoku

Un identifiant absent, mal formé ou en double renvoie 422 invalid_indicator.

#La règle de plafond

Un indicateur a besoin d’un warm-up (des bougies antérieures à la première valeur publiable). La règle est :

limit + warmup(type, parameters) <= 1000

Au-delà, la requête rend 422. Sur les types à échauffement linéaire, le message donne la période maximale utilisable pour la limit demandée.

#La réponse

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

• Les clés de data.indicators sont vos identifiants.
• Chaque entrée rappelle son type et ses paramètres effectifs, valeurs par défaut remplies : vous savez toujours ce qui a été calculé.
• values est une liste de lignes datées, de la plus récente à la plus ancienne comme toute liste de BytNode : chaque ligne est {time, value}, ou time et les sorties nommées d’un indicateur à plusieurs sorties (macd, signal, histogram ; upper, middle, lower…). time est le début de la bougie de cette ligne.
• Une valeur non définie sort en null, jamais en NaN.
• Les sorties à plusieurs clés suivent l’ordre déclaré par le type, pas celui du moteur de calcul.

#Différences de convention

Ces différences viennent de mesures, pas de préférences. Les connaître évite de chercher un bug là où il n’y en a pas.

#Erreurs

L’ordre de validation est fixe : unité de temps, puis limit, puis symbole, puis analyse des indicateurs, puis règle de plafond, puis lecture des bougies. Le premier échec l’emporte.