API de dérivés crypto

#Données de dérivés crypto pour agents IA et LLM

« Le funding de BTC est-il positif ? », « Combien d’open interest ETH a-t-il pris aujourd’hui ? », « Quel côté a été liquidé dans l’heure ? » : un agent IA branché par MCP répond avec cette famille, pour une paire ou jusqu’à dix comparées, par l’outil get_pair_data.

{
  "name": "get_pair_data",
  "arguments": {
    "symbol": ["BTCUSDT", "ETHUSDT"],
    "fields": ["funding_next", "oi", "liquidations_cumulative"],
    "timeframe": "1h"
  }
}

• Pour le LLM : un rate_pct de funding est un pourcentage pour une fenêtre de huit heures, pas un taux annuel ; apr_pct l’annualise. Le citer comme un rendement annuel est le contresens classique.
• Pour les développeurs : dans votre propre agent IA, /v1/funding/rate et /v1/oi font deux outils simples pour le tool calling ; le serveur MCP les expose déjà, sous les mêmes noms et unités.
• 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.

#Intérêt ouvert

L’intérêt ouvert total, additionné sur toutes les places, une ligne par intervalle clos de timeframe (obligatoire, 1m à 1d) : pour chaque place sa dernière valeur dans l’intervalle, comme une clôture. La valeur courante est /v1/oi.

La variation de l’intérêt ouvert : le capital qui entre ou qui sort. Le pourcentage est recalculé à partir des totaux agrégés, pour rester cohérent avec la somme.

#Funding

Trois lectures du même phénomène : le dernier taux appliqué, le prochain estimé, et le total cumulé sur les dernières vingt-quatre heures. Tous sont des composites pondérés par l’intérêt ouvert (la place qui porte le plus de positions pèse le plus) et ramenés à une base de huit heures avant pondération, car certaines paires règlent toutes les quatre heures ou toutes les heures.

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

#Liquidations

Les liquidations individuelles, toutes places confondues. La couverture est ici structurellement plus faible que sur les transactions : toutes les places ne publient pas de flux public de liquidations.

Le rapport entre les grosses liquidations (au moins 100 000 $) et les petites. Il distingue une purge de gros comptes d’une cascade de petits porteurs.

#Base

L’écart entre le prix à terme et le prix spot, une moyenne pondérée par l’intérêt ouvert sur les places qui portent les deux marchés. Les deux prix sont pondérés de la même façon, ce qui garantit que basis_value = futures_price − spot_price reste vrai.

#Écarts entre places

La seule surface de BytNode qui nomme les places de marché, un écart n’ayant pas de sens sans elles. Le modèle est une prime par place : un prix de référence multi-places, puis l’écart de chaque place à cette référence. Toute paire se déduit côté client, par la différence de deux primes.

{
  "status": "ok",
  "server_time": "2026-10-14T09:06:22.870Z",
  "data_type": "spread_interexchange",
  "symbol": "BTCUSDT",
  "timeframe": "1h",
  "market": "futures",
  "data": {
    "time": "2026-10-14T08:00:00.000Z",
    "is_closed": true,
    "ref_price": 83706.7967743,
    "weighting": "volume",
    "max_spread_bps": 18.8831076757,
    "high_venue": "venue_a",
    "high_price": 83720.69106,
    "low_venue": "venue_b",
    "low_price": 83562.6266143,
    "venues": [
      { "venue": "venue_a", "price": 83720.69106, "premium_bps": 1.65987545135 },
      { "venue": "venue_c", "price": 83715.3204619, "premium_bps": 1.01827903431 }
    ]
  }
}