API REST

Dérivés

Le positionnement sur les futures : combien de capital est engagé, à quel coût, dans quel sens, et à quel prix par rapport au spot. Toutes ces métriques sont des composites, et la pondération utilisée est indiquée pour chacune.

#Intérêt ouvert

GET/v1/raw/oidata_type · raw_oi

L’intérêt ouvert total, additionné sur toutes les places, par fenêtres d’une minute. Chaque place garde sa dernière valeur connue quand son rafraîchissement saute une minute, et une minute n’est servie que si toutes les places y sont représentées : sans cela, le total oscillerait artificiellement.

ParamètreTypeDéfautDescription
symbolstringobligatoireL’actif.
limitinteger30Nombre de minutes, de 1 à 1000.
ChampTypeDescription
timestampstringDébut de la minute.
oi_totalfloatIntérêt ouvert additionné. Le nom dit l’agrégat : ce n’est pas la valeur d’une seule place.
GET/v1/oi/deltadata_type · oi_delta
GET/v1/oi/delta/historydata_type · oi_delta_history

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.

ChampTypeDescription
oi_currentfloatIntérêt ouvert cumulé actuel.
oi_previousfloatLe précédent.
deltafloatLa différence.
delta_pctfloat | nullLa variation en pourcentage.
timestampstringHorodatage du calcul.

#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.

GET/v1/funding/ratedata_type · funding_rate_8h
GET/v1/funding/rate/historydata_type · funding_rate_8h_history
ChampTypeDescription
bucketstringDébut de la fenêtre de 8 h, alignée sur 00:00, 08:00 et 16:00 UTC.
ratefloatLe taux composite sur la fenêtre, en équivalent 8 h.
aprfloatLe taux annualisé : taux × 1095, soit 1095 règlements de 8 h par an. Absent de l’historique.
exchange_countintegerNombre de places agrégées sur la fenêtre.
GET/v1/funding/nextdata_type · funding_next_estimated
ChampTypeDescription
estimated_ratefloatLe taux estimé, en équivalent 8 h.
settlement_atstringHorodatage du règlement connu le plus récent.
is_pastbooleanVrai si ce règlement est déjà passé.
aprfloatAnnualisé.
exchange_countintegerNombre de places agrégées.
GET/v1/funding/cumulativedata_type · funding_cumulative_24h
GET/v1/funding/cumulative/historydata_type · funding_cumulative_24h_history
curl
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/funding/cumulative?symbol=BTCUSDT"
ChampTypeDescription
timestampstringBucket de la fenêtre de 8 h la plus récente.
cumulative_ratefloatSomme des composites 8 h sur la plage.
aprfloatAnnualisé sur le nombre de fenêtres réellement additionnées, ce qui reste exact même quand l’une manque.
window_countintegerNombre de fenêtres de 8 h réellement additionnées, trois au plus.

#Liquidations

GET/v1/raw/liquidationsdata_type · raw_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.

ParamètreTypeDéfautDescription
symbolstringobligatoireL’actif.
limitinteger30Nombre d’événements, de 1 à 1000.
min_usdfloat—Filtre facultatif sur la valeur en dollars.
ChampTypeDescription
timestampstringHorodatage.
sidestringlong ou short : le côté de la position liquidée, pas celui de l’ordre. La convention est normalisée entre les places.
pricefloatPrix de liquidation.
quantityfloatTaille en unités de l’actif de base.
usd_valuefloatValeur en dollars.
GET/v1/liquidations/cumulativedata_type · liquidations_cumulative
GET/v1/liquidations/cumulative/historydata_type · liquidations_cumulative_history
ChampTypeDescription
timestampstringHorodatage du calcul.
long_usdfloatDollars de positions acheteuses liquidées.
short_usdfloatDollars de positions vendeuses liquidées.
total_usdfloatLe total.
GET/v1/liquidations/ratiodata_type · liquidation_ratio
GET/v1/liquidations/ratio/historydata_type · liquidation_ratio_history

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.

ChampTypeDescription
big_count / big_usdinteger / floatLiquidations d’au moins 100 000 $.
small_count / small_usdinteger / floatCelles en dessous.
ratiofloat | nullbig_usd divisé par small_usd. null si le dénominateur est nul.
timestampstringHorodatage du calcul.

#Ratio long/short

GET/v1/ls-ratiodata_type · ls_ratio_composite
GET/v1/ls-ratio/historydata_type · ls_ratio_composite_history

La part des comptes positionnés à l’achat, en variante compte global, composée sur les places qui la publient et pondérée par l’intérêt ouvert. Au moins deux places sont nécessaires sur une fenêtre, sinon la réponse vaut null.

ParamètreTypeDéfautDescription
symbolstringobligatoireL’actif.
timeframestringobligatoire5m, 15m, 30m, 1h, 4h, 1d. L’unité de temps 1m est refusée : aucune place ne publie à cette cadence.
livebooleanfalseExpose la fenêtre en cours.
limitinteger30Sur l’historique, de 1 à 500.
ChampTypeDescription
timestampstringDébut de la fenêtre.
timeframestringL’unité de temps demandée.
part_longfloatPart des comptes acheteurs, strictement entre 0 et 1.
ratiofloatAcheteurs divisés par vendeurs.
venue_countintegerNombre de places agrégées, deux au moins.
weightingstringoi quand la pondération par l’intérêt ouvert a pu être appliquée, geomean en repli.
is_closedbooleanFaux uniquement avec live=1.

#Base

GET/v1/basisdata_type · basis
GET/v1/basis/historydata_type · basis_history

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.

ChampTypeDescription
basis_valuefloatL’écart en dollars.
basis_pctfloatL’écart en pourcentage.
futures_pricefloatPrix futures composite.
spot_pricefloatPrix spot composite.
timestampstringHorodatage du calcul.

Fenêtre par défaut de l’historique

Sans since_ms ni until_ms, la recherche remonte de limit minutes. Avec une fenêtre explicite, c’est elle qui s’applique.

#Écarts entre places

GET/v1/spread/interexchangedata_type · spread_interexchange_<tf>
GET/v1/spread/interexchange/historydata_type · spread_interexchange_<tf>_history

La seule surface de l’API 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.

ParamètreTypeDéfautDescription
symbolstringobligatoireL’actif.
timeframestringobligatoire1m, 5m, 15m, 30m, 1h, 4h, 1d.
livebooleanfalseExpose la fenêtre en cours.
limitinteger30Sur l’historique, de 1 à 500. Pas de fenêtre datée.
Réponse
{
  "status": "ok",
  "data_type": "spread_interexchange_1m",
  "data": {
    "timestamp": "2026-08-29T11:38:00+00:00",
    "timeframe": "1m",
    "is_closed": true,
    "ref_price": 71420.83,
    "weighting": "volume",
    "max_spread_bps": 5.4,
    "max_spread_pct": 0.054,
    "high": { "exchange": "venue_a", "price": 71423.10 },
    "low":  { "exchange": "venue_b", "price": 71414.55 },
    "venue_count": 2,
    "venues": [
      { "exchange": "venue_a", "price": 71423.10, "premium_bps":  3.2 },
      { "exchange": "venue_b", "price": 71414.55, "premium_bps": -2.2 }
    ]
  }
}
ChampTypeDescription
ref_pricefloatPrix de référence multi-places.
weightingstringvolume en régime nominal, mean en repli quand le volume manque.
max_spread_bps / max_spread_pctfloatL’amplitude entre la place la plus haute et la plus basse.
high / lowobjectLa place extrême et son prix.
venue_countintegerNombre de places sur la fenêtre, deux au moins.
venuesarrayUne entrée par place : exchange, price, premium_bps. Triées par prime décroissante.
is_closedbooleanFaux uniquement avec live=1.