Genesis Arbitrage

Genesis Arbitrage · · 16 min de lecture

API open interest : l’OI des futures par exchange et comment le lire

En bref

  • L’open interest est le volume des positions sur futures qui restent ouvertes. Compté en coins, il montre l’afflux de positions ; compté en dollars, il suit aussi le prix.
  • Chaque exchange publie l’OI dans son propre format et ses propres unités. Dans Genesis API, un seul appel à /market/open-interest couvre 13+ exchanges, avec la somme dans total, le détail dans exchanges, ainsi que les variations d’OI et de prix sur 5, 15 et 30 minutes et sur 1 heure, sur tous les plans.
  • Lu avec le prix et le funding, l’OI montre qui construit des positions et qui paie pour les tenir. Il ne prédit pas le prix ; la décision et le trade sur l’exchange restent les vôtres.

Une API open interest renvoie, pour chaque coin, le volume de positions ouvertes sur futures, en coins et en dollars, par exchange et au total, avec sa variation sur les dernières minutes et heures. Les exchanges publient l’OI de leurs contrats via leurs propres API, et les formats diffèrent d’un exchange à l’autre. Dans Genesis API, tout le snapshot vient d’un seul appel à /market/open-interest : 13+ exchanges de futures, dont Binance, Bybit, OKX, Bitget et Gate, avec les variations d’OI et de prix sur 5, 15 et 30 minutes et sur 1 heure, sur tous les plans, à partir de Trial à 20 $ par mois.

Ce qu’est l’open interest

L’open interest (OI) est le total des positions d’un contrat futures qui sont ouvertes et pas encore clôturées. Chaque contrat a deux côtés, un long et un short, et l’OI n’en compte qu’un : un trader achète 1 BTC en long, un autre vend 1 BTC en short, et l’open interest augmente de 1 BTC.

L’OI monte quand les deux parties d’un trade ouvrent des positions, baisse quand les deux clôturent, et reste stable quand une position passe d’un trader à un autre. Ainsi, un OI en hausse signifie que de nouvelles positions arrivent, et un OI en baisse que des positions sont fermées, volontairement ou de force.

OI en coins et en dollars

Les exchanges indiquent l’OI en contrats, en coins ou directement en dollars, et les coins sont convertis en dollars au prix. Dans l’exemple de réponse de Genesis API, l’oi_usd de ByBit pour GRAM est égal à oi_tokens multiplié par price : 16 159 003,8 × 1,6609 = 26 838 489,41.

Le chiffre en dollars est pratique pour comparer coins et exchanges, mais il suit le prix. Exemple illustratif : un exchange compte 2 000 000 de coins en positions ouvertes à 1,50 $, donc l’OI est de 2 000 000 × 1,50 $ = 3 000 000 $. Une heure plus tard, les positions n’ont pas changé, le prix est de 1,65 $ et l’OI en dollars atteint déjà 2 000 000 × 1,65 $ = 3 300 000 $, soit 10 % de plus sans la moindre nouvelle position.

OI total et détail par exchange

L’OI total d’un coin additionne l’OI des exchanges qui listent ses futures et montre combien d’argent le marché engage en positions. Le détail montre où se trouve cet argent : dans la même réponse, ByBit détient 26 838 489,41 / 96 544 685,3 × 100 = 27,8 % de l’OI en dollars de GRAM.

MesureCe qu’elle montreLe piège
OI en coinsCombien de positions sont ouvertesLa taille des contrats diffère selon l’exchange
OI en dollarsCombien d’argent est engagé en positionsSuit le prix
OI totalLes positions sur l’ensemble du marchéDépend des exchanges additionnés
OI par exchangeOù les positions se construisentLes méthodes des exchanges diffèrent

Ce que renvoient les API de Binance, Bybit, OKX et Hyperliquid

Chaque exchange publie l’OI de ses contrats via sa propre API. Voici ce que dit la documentation officielle :

ExchangeOI actuelHistorique d’OIÀ surveiller
BinanceGET /fapi/v1/openInterest, un symbol par requêteGET /futures/data/openInterestHistL’historique ne couvre que le dernier mois
BybitGET /v5/market/tickers, tous les symboles en une requêteGET /v5/market/open-interest, pas de 5min à 1dopenInterest compte les deux côtés, singleOpenInterest un seul
OKXGET /api/v5/public/open-interestGET /api/v5/rubik/stat/contracts/open-interest-historyoi en contrats, oiCcy en coins, oiUsd en dollars
HyperliquidPOST /info, type metaAndAssetCtxsAbsent de la documentationOI des futures perpétuels en une seule requête

Les détails figurent dans les documentations de Binance, Bybit, OKX et Hyperliquid. L’historique de Binance arrive sous la forme sumOpenInterest et sumOpenInterestValue, tandis qu’OKX renvoie les 1 440 dernières entrées par pas à partir de 5 minutes. Hyperliquid accepte une requête vers https://api.hyperliquid.xyz/info avec le corps {"type": "metaAndAssetCtxs"} et renvoie openInterest pour chaque perpétuel, à côté de markPx et funding.

L’écart de méthode peut être du simple au double. Dans l’exemple de réponse /v5/market/open-interest de Bybit, openInterest vaut 63 910 691 et singleOpenInterest 31 955 346, exactement la moitié : le premier compte les deux côtés, le second un seul, comme dans la définition de l’OI ci-dessus.

Construire un snapshot soi-même, c’est interroger chaque exchange selon ses règles, convertir les contrats en coins puis les coins en dollars, et rester dans les limites de chaque plateforme. Sur Binance, cela demande une requête distincte pour chaque contrat.

L’open interest dans Genesis API : /market/open-interest

L’endpoint /market/open-interest renvoie les mêmes données que le tableau OI Tracking du site : l’OI total de chaque coin dans total et le détail par exchange dans exchanges. Sans paramètres, vous obtenez tous les coins ; coin garde un seul coin, et exchange garde les exchanges choisis, séparés par des virgules s’il y en a plusieurs.

curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
  -d coin=GRAM \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

La réponse est un tableau data. Voici l’un de ses éléments tiré de la documentation, avec certains champs coupés :

{
  "coin": "GRAM",
  "total": {
    "oi_usd": 96544685.3,
    "oi_tokens": 58105803.3,
    "avg_price": 1.661224,
    "volume_24h": 47010004.63,
    "oi_change_5m": 0.0196,
    "oi_change_1h": 0.3185,
    "price_change_5m": -0.0228,
    "price_change_1h": -0.1929,
    …
  },
  "exchanges": {
    "ByBit": {
      "price": 1.6609,
      "oi_usd": 26838489.41,
      "oi_tokens": 16159003.8,
      "oi_change_1h": -0.097,
      "price_change_1h": -0.1683,
      "trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
      …
    }
  }
}
ChampSignification
total.oi_usd / total.oi_tokensOI total en dollars et en coins
total.avg_pricePrix moyen du coin sur les exchanges
total.volume_24hVolume sur 24 h, USD
total.oi_change_5m/15m/30m/1hVariation de l’OI sur 5, 15 et 30 minutes et 1 heure, %
total.price_change_5m/15m/30m/1hVariation du prix sur les mêmes intervalles, %
exchanges{}Les mêmes métriques par exchange : price à la place de avg_price, plus trade_url

Les variations sont des pourcentages : 0.3185 signifie 0,3185 %. Les valeurs vides arrivent sous la forme null, ignorez-les. La fraîcheur dépend du plan : 60 s sur Trial, 30 s sur Start, 10 s sur Pro et 5 s sur Max, donc interroger plus souvent que meta.freshness_sec n’apporte rien.

Une réponse non filtrée porte un en-tête ETag. Renvoyez-le dans If-None-Match, et un snapshot inchangé revient en 304, qui ne consomme pas votre quota ; le mécanisme est expliqué dans ETag et If-None-Match. Le filtre exchange ne restreint que exchanges : total reste calculé sur tous les exchanges.

Les champs, les paramètres et le formulaire « Essayer » se trouvent dans la section de documentation "OI Tracking". Tous les endpoints de marché sont parcourus avec des exemples dans le guide Données de marché de Genesis API.

Lire l’OI avec le prix : quatre scénarios

Un OI en hausse indique que des positions s’ouvrent, mais pas quel côté mène. Le prix sur le même intervalle donne l’indice.

PrixOILecture habituelleÀ vérifier
HausseHausseNouvelles positions dans le sens du mouvement, la hausse est soutenue par de l’argentFunding : fortement positif signifie des longs surchargés
BaisseHausseLes shorts s’accumulent, ou des longs achètent dans la baisseFunding : fortement négatif signifie un risque de short squeeze
HausseBaisseLa hausse repose sur des clôtures de shorts, sans argent fraisSi l’OI baisse sur tous les exchanges
BaisseBaisseLes longs se ferment, par choix ou de forceUn OI qui s’effondre en 5 minutes pointe vers des liquidations

Dans l’exemple de la documentation, l’OI total de GRAM a gagné 0,32 % en une heure alors que le prix perdait 0,19 %, ce qui le range formellement dans la deuxième ligne. Mais des fractions de pour cent par heure sont du bruit ordinaire : lisez les scénarios sur des mouvements nets et sur des coins à gros OI.

OI et funding : qui tient des positions et qui les paie

Le taux de financement (funding) montre quel côté des futures perpétuels paie l’autre, et l’OI montre combien de positions sont ouvertes. Ensemble, ils indiquent à la fois dans quel sens penche le marché et à quel point il est endetté par l’effet de levier.

Un OI et un prix en hausse avec un taux fortement positif signifient que les longs ajoutent des positions et paient les shorts pour les tenir. Si le prix se retourne, leurs liquidations accélèrent la chute. Un OI et un prix en hausse avec un taux négatif signifient que les shorts se construisent contre le mouvement, et une forte hausse peut les fermer de force.

Toutes les combinaisons de funding, d’OI et de prix sont détaillées dans Le taux de funding comme indicateur de marché. Dans Genesis API, /funding/rates renvoie le taux de chaque exchange, lui aussi sur tous les plans : le taux par intervalle de funding (funding_pct) et le taux normalisé sur 8 heures (funding_8h_pct). Les endpoints de funding et l’historique du funding réglé sont traités dans API de taux de funding, et les champs dans la documentation.

Python : OI en hausse de plus de 5 % en une heure alors que le prix monte

Le script récupère tout le snapshot en un appel et garde les coins dont l’OI total a progressé de plus de 5 % en une heure alors que le prix montait, avec un OI d’au moins 5 M$. Pour chacun, il affiche le détail par exchange : la part de l’exchange dans l’OI ainsi que ses variations d’OI et de prix sur l’heure. La clé vient de la variable d’environnement GENESIS_API_KEY ; sur 429 et 503, le script attend Retry-After secondes et réessaie.

import os
import time
import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
MIN_OI_USD = 5_000_000  # avec un petit OI, une seule position le fait beaucoup bouger

def get(path, **params):
    while True:
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):  # rate limit ou reconstruction des données
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]

def passes(t):
    oi, px = t.get("oi_change_1h"), t.get("price_change_1h")
    if oi is None or px is None:
        return False
    return (t.get("oi_usd") or 0) >= MIN_OI_USD and oi > 5 and px > 0

def pct(v):
    return "n/d" if v is None else f"{v:+.1f}%"

hits = [r for r in get("/market/open-interest") if passes(r["total"])]
for row in hits:
    t = row["total"]
    print(f"{row['coin']} : OI {pct(t['oi_change_1h'])} en 1 h, "
          f"prix {pct(t['price_change_1h'])}, "
          f"total ${t['oi_usd'] / 1e6:.1f}M")
    exs = sorted(row["exchanges"].items(), reverse=True,
                 key=lambda kv: kv[1].get("oi_usd") or 0)
    for name, m in exs:
        share = (m.get("oi_usd") or 0) / t["oi_usd"] * 100
        print(f"  {name:<8} part {share:4.1f}%, "
              f"OI {pct(m.get('oi_change_1h'))}, "
              f"prix {pct(m.get('price_change_1h'))}")

Sortie illustrative pour le coin XYZ : OI +6,2 % en une heure, prix +3,0 %, OI total 48,1 M$.

ExchangePart de l’OIOI 1 hPrix 1 h
Binance46,2 %+8,0 %+3,0 %
ByBit27,0 %+5,0 %+3,1 %
OKX17,5 %+2,0 %+2,9 %
Bitget9,3 %+9,0 %+3,2 %

La croissance est large : l’OI a progressé sur les quatre exchanges, et de 5 % ou plus sur trois d’entre eux. Si le même +6,2 % était venu d’un seul exchange qui détenait 10 % de l’OI du coin une heure plus tôt, son OI aurait dû grimper de 62 % : 0,10 × 62 = 6,2. Un pic sur une seule plateforme indique plus souvent un gros acteur unique, et il est trop tôt pour en tirer des conclusions sur le marché.

La seconde partie ajoute le funding : un appel à /funding/rates pour tous les coins et, pour chaque coin trouvé, le taux sur 8 heures le plus bas et le plus haut entre exchanges, et le nombre d’exchanges où le taux est positif.

# taux de funding de tous les exchanges : un appel couvre tous les coins
rates = {row["coin"]: row["exchanges"]
         for row in get("/funding/rates")}

for row in hits:
    fr = sorted((e["funding_8h_pct"], e["exchange"])
                for e in rates.get(row["coin"], [])
                if e.get("funding_8h_pct") is not None)
    if not fr:
        print(f"{row['coin']} : aucun taux de funding")
        continue
    (lo, lo_ex), (hi, hi_ex) = fr[0], fr[-1]
    plus = sum(1 for rate, _ in fr if rate > 0)
    print(f"{row['coin']} : funding 8 h de {lo:+.4f}% ({lo_ex}) "
          f"à {hi:+.4f}% ({hi_ex}), positif sur {plus} sur {len(fr)}")

Le script fait deux appels. Lancé une fois par minute, cela représente 2 × 60 × 24 × 30 = 86 400 appels par 30 jours, moins d’un cinquième du quota de 500K du plan Trial. Pour interroger en boucle sans dépenser de quota sur des données inchangées, ajoutez ETag et If-None-Match : les techniques sont dans Comment interroger une API sans atteindre les limites, et les quotas et requêtes par seconde dans le guide des limites de Genesis API.

Réserves : ce qui fausse l’open interest

Sans code, les mêmes données sont dans le tableau OI Tracking du site ; ses colonnes, filtres et graphiques sont décrits dans le guide. Les quotas et les prix des plans de l’API figurent sur la page des tarifs de Genesis API.

Questions et réponses

En quoi l’open interest diffère-t-il du volume d’échanges ?

Le volume est la somme des trades sur une période ; l’open interest correspond aux positions qui restent ouvertes en ce moment. Chaque trade compte dans le volume, mais ne change l’OI que lorsque les deux parties ouvrent ou clôturent des positions. Un volume élevé avec un OI stable signifie que les positions changent surtout de mains. La réponse de /market/open-interest contient les deux chiffres : volume_24h et oi_usd.

Où trouver l’historique de l’open interest ?

Genesis API n’a pas d’historique : l’endpoint renvoie le snapshot actuel et les variations sur 5, 15 et 30 minutes et 1 heure, donc une longue série se construit en sauvegardant les réponses. Les exchanges proposent un historique dans leurs propres API : Binance sur le dernier mois, Bybit par pas de 5 minutes à un jour, OKX les 1 440 dernières entrées. Sur le site, le bouton Graphique d’OI Tracking ouvre un graphique d’OI avec le plan Pro du site.

À quelle fréquence les données d’OI sont-elles mises à jour dans Genesis API ?

La fraîcheur dépend du plan de l’API : 60 secondes sur Trial, 30 sur Start, 10 sur Pro et 5 sur Max. L’heure de construction du snapshot est dans meta.updated_at, et le délai de votre plan dans meta.freshness_sec. Interroger plus vite que ce délai n’apporte rien, et avec If-None-Match un snapshot inchangé revient en 304, qui ne consomme pas votre quota.

Que signifie un open interest en hausse avec un prix en baisse ?

En général, de nouveaux shorts s’ouvrent, ou quelqu’un achète des longs contre le mouvement. Si le funding devient négatif en même temps, les shorts paient aussi les longs pour tenir leurs positions. Un retournement brutal à la hausse à ce moment-là peut forcer les shorts à fermer et accélérer la hausse.