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.
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ètre
Type
Défaut
Description
symbol
string
obligatoire
L’actif.
limit
integer
30
Nombre de minutes, de 1 à 1000.
Champ
Type
Description
timestamp
string
Début de la minute.
oi_total
float
Intérêt ouvert additionné. Le nom dit l’agrégat : ce n’est pas la valeur d’une seule place.
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.
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.
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ètre
Type
Défaut
Description
symbol
string
obligatoire
L’actif.
limit
integer
30
Nombre d’événements, de 1 à 1000.
min_usd
float
—
Filtre facultatif sur la valeur en dollars.
Champ
Type
Description
timestamp
string
Horodatage.
side
string
long ou short : le côté de la position liquidée, pas celui de l’ordre. La convention est normalisée entre les places.
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.
Champ
Type
Description
big_count / big_usd
integer / float
Liquidations d’au moins 100 000 $.
small_count / small_usd
integer / float
Celles en dessous.
ratio
float | null
big_usd divisé par small_usd. null si le dénominateur est nul.
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ètre
Type
Défaut
Description
symbol
string
obligatoire
L’actif.
timeframe
string
obligatoire
5m, 15m, 30m, 1h, 4h, 1d. L’unité de temps 1m est refusée : aucune place ne publie à cette cadence.
live
boolean
false
Expose la fenêtre en cours.
limit
integer
30
Sur l’historique, de 1 à 500.
Champ
Type
Description
timestamp
string
Début de la fenêtre.
timeframe
string
L’unité de temps demandée.
part_long
float
Part des comptes acheteurs, strictement entre 0 et 1.
ratio
float
Acheteurs divisés par vendeurs.
venue_count
integer
Nombre de places agrégées, deux au moins.
weighting
string
oi quand la pondération par l’intérêt ouvert a pu être appliquée, geomean en repli.
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.
Champ
Type
Description
basis_value
float
L’écart en dollars.
basis_pct
float
L’écart en pourcentage.
futures_price
float
Prix futures composite.
spot_price
float
Prix spot composite.
timestamp
string
Horodatage 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.
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ètre
Type
Défaut
Description
symbol
string
obligatoire
L’actif.
timeframe
string
obligatoire
1m, 5m, 15m, 30m, 1h, 4h, 1d.
live
boolean
false
Expose la fenêtre en cours.
limit
integer
30
Sur l’historique, de 1 à 500. Pas de fenêtre datée.