API de funding rate : les taux de tous les exchanges en une requête, plus l’historique du funding versé
En bref
- Une API de funding rate doit renvoyer, pour chaque exchange, le taux par intervalle, l’intervalle lui-même, l’heure du prochain funding, le taux ramené à 8 heures et le prix du future.
- Binance, Bybit, OKX et Hyperliquid ont chacun leurs endpoints, leurs unités et leur façon d’indiquer l’intervalle. Genesis API
/funding/ratesrenvoie les taux de tous les exchanges en une seule requête GET, en pourcentage et normalisés sur 8 heures. - L’historique du funding versé sur 13 exchanges (sommes, taux moyens, APR, un an de sommes quotidiennes et un screener de combinaisons avec
netaprès frais) se trouve dans/funding/analytics/*sur les plans Pro et Max.
Une API de funding rate renvoie, pour les futures perpétuels de chaque exchange, les taux de financement : le taux par intervalle, l’intervalle lui-même et l’heure du prochain funding et, dans sa version complète, l’historique du funding versé. Chaque exchange a sa propre API avec ses chemins, ses unités et ses intervalles ; pour les comparer, on réunit donc les taux dans un seul tableau, on les convertit en pourcentage et on les normalise sur une même période, en général 8 heures.
Ce que doit renvoyer une API de funding rate
Un taux sans son intervalle ne dit rien : 0,02 % toutes les 4 heures et 0,02 % toutes les 8 heures diffèrent d’un facteur deux. C’est pourquoi une API crypto de taux de financement utile renvoie cinq valeurs pour chaque paire monnaie–exchange.
| Ce qu’il faut | Pourquoi | Champ de /funding/rates |
|---|---|---|
| Taux par intervalle | Montant du prochain paiement | funding_pct |
| Intervalle de funding | Sans lui, impossible de comparer les taux | interval |
| Heure du prochain funding | La position doit être ouverte à ce moment-là | next_payout |
| Taux sur 8 heures | Comparer des exchanges aux intervalles différents | funding_8h_pct |
| Prix du future | L’écart de prix entre les jambes décale l’entrée | price |
Le paiement est la taille de la position multipliée par le taux : une position de 10 000 $ à 0,01 % reçoit ou paie 1 $ à chaque règlement.
Pourquoi les intervalles diffèrent selon les exchanges et comment ramener un taux à 8 heures
Chaque exchange décide de la fréquence de règlement du funding et peut modifier l’intervalle d’un contrat donné. Dans l’analytique de Genesis API, les intervalles des CEX sont de 8 et 4 heures, tandis qu’Hyperliquid et Lighter règlent toutes les heures. Hyperliquid calcule le taux comme un taux sur 8 heures et en verse un huitième chaque heure, comme décrit dans les règles de funding d’Hyperliquid.
Dans l’exemple de la documentation de Genesis API, MEXC prélève 0,02 % sur TON toutes les 4 heures : 0,02 × 8 / 4 = 0,04 % sur 8 heures. Un exemple hypothétique avec un intervalle d’une heure : l’exchange A verse 0,004 % chaque heure, l’exchange B verse 0,02 % toutes les 8 heures. En chiffres bruts, A verse cinq fois moins, mais sur 8 heures cela donne 0,004 × 8 / 1 = 0,032 % contre 0,02 %, soit 1,6 fois plus.
La normalisation suppose que le taux tient pendant toute la période, alors qu’un taux horaire peut changer dès le règlement suivant. Seul l’historique montre ce qui a réellement été versé.
L’APR se calcule à partir du taux sur 8 heures : trois règlements par jour, 1 095 par an. Pour l’exchange A, cela donne 0,032 × 3 × 365 = 35,04 % par an, tant que le taux se maintient.
Les API de funding rate des exchanges : Binance, Bybit, OKX et Hyperliquid
Chaque grand exchange a sa propre API de funding rate : ses chemins, ses champs et sa façon d’indiquer l’intervalle.
| Exchange | Taux actuel | Historique | Intervalle |
|---|---|---|---|
| Binance | GET /fapi/v1/premiumIndex | GET /fapi/v1/fundingRate | GET /fapi/v1/fundingInfo |
| Bybit | GET /v5/market/tickers | GET /v5/market/funding/history | champ fundingIntervalHour |
| OKX | GET /api/v5/public/funding-rate | GET /api/v5/public/funding-rate-history | d’après fundingTime et nextFundingTime |
| Hyperliquid | POST /info, metaAndAssetCtxs | POST /info, fundingHistory | toutes les heures |
L’API de funding rate de Binance renvoie le taux et l’heure du prochain funding dans les champs lastFundingRate et nextFundingTime de premiumIndex (documentation Binance), et l’historique des taux de Binance provient de fundingRate, qui accepte startTime et endTime (historique des taux de funding). fundingInfo ne renvoie l’intervalle que pour les contrats dont l’exchange a ajusté l’intervalle ou le plafond de taux (description de l’endpoint).
Bybit renvoie fundingRate, nextFundingTime et fundingIntervalHour dans une seule réponse de tickers avec category=linear (tickers Bybit), et sa requête d’historique exige symbol (historique de funding Bybit). Comme le précise la documentation, chaque contrat a son propre intervalle.
Pour OKX, la documentation propose de déduire l’intervalle d’un contrat de la différence entre nextFundingTime et fundingTime (documentation OKX).
Hyperliquid reçoit toutes les requêtes de données sur POST https://api.hyperliquid.xyz/info, et c’est le corps JSON qui détermine la réponse : {"type": "metaAndAssetCtxs"} renvoie le funding actuel de chaque actif, {"type": "fundingHistory", "coin": "ETH", "startTime": …} renvoie l’historique des taux (documentation Hyperliquid).
Pour fusionner ces exchanges dans un seul tableau, votre code doit :
- convertir les taux de fractions en pourcentage ;
- trouver l’intervalle de chaque contrat et ramener le taux à 8 heures ;
- convertir les horodatages depuis les millisecondes et faire correspondre les tickers :
BTCUSDT,BTC-USDT-SWAP,BTC, ainsi que des multiplicateurs comme1000PEPEsur les petites monnaies ; - respecter les rate limits de chaque exchange et mettre le code à jour quand il change son API.
Tous les exchanges en une requête : /funding/rates
GET /funding/rates renvoie, pour chaque monnaie, la liste des exchanges avec le taux actuel : Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, HTX, Hyperliquid et les autres exchanges couverts par Genesis Arbitrage, plus de 1000 monnaies au total. Les filtres coin et exchange (séparés par des virgules pour plusieurs exchanges) sont facultatifs ; sans eux, vous obtenez l’ensemble complet.
curl --compressed \
"https://api.genesisarbitrage.com/v1/funding/rates?coin=TON" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "TON",
"exchanges": [
{
"exchange": "MEXC",
"funding_pct": 0.02,
"funding_8h_pct": 0.04,
"next_payout": "00:00",
"interval": "4h",
"price": 2.184,
"trade_url": "https://futures.mexc.com/exchange/TON_USDT"
}
]
}
Voici un élément du tableau data à l’intérieur de l’enveloppe commune à toutes les réponses de Genesis API : success, data, meta. Les taux sont en pourcentage, next_payout est l’heure du paiement au format HH:MM UTC, les valeurs vides valent null et Hyperliquid apparaît sous le nom Hyper. Tous les champs et le formulaire Essayer se trouvent dans la section Taux de funding de la documentation.
/funding/rates et /funding/spread sont disponibles sur tous les plans, à partir de Trial à 20 $ par mois : 500 K appels, 1 requête par seconde, fraîcheur des données de 60 s (tarifs de Genesis API).
Spread de funding : /funding/spread
Le spread de funding est l’écart entre le taux le plus élevé et le plus bas d’une monnaie selon les exchanges, après normalisation sur 8 heures. Le short se place là où le taux est le plus élevé et le long là où il est le plus bas : le short reçoit le taux de son exchange, le long paie le sien (ou reçoit, si ce taux est négatif), et la différence est ce qui reste.
GET /funding/spread renvoie, pour chaque monnaie, la meilleure paire d’exchanges dans best : exchange_1 et exchange_2, leurs taux selon leur propre intervalle (funding_1_pct, funding_2_pct), les intervalles, les heures de paiement et les liens vers le terminal. Le spread de la paire se trouve dans spread_pct, les autres exchanges dans others, et les filtres sont coin et min_spread (documentation du Spread de funding). Les intervalles d’une paire diffèrent souvent, comme 1h et 8h pour BTC dans l’exemple de la documentation ; ne comparez donc les taux d’une paire à la main qu’après les avoir normalisés sur 8 heures.
Python : top 10 des spreads de funding, annualisés
Le script prend l’ensemble complet de /funding/rates et, pour chaque monnaie, trouve les exchanges au funding_8h_pct le plus élevé et le plus bas : la différence est le spread sur 8 heures, annualisé par spread × 3 × 365. Sur 429 et 503, il attend Retry-After secondes, mais pas plus d’une minute : quand le quota mensuel est épuisé, Retry-After court jusqu’à la réinitialisation du quota.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/rates"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def fetch_rates():
for _ in range(3):
r = requests.get(URL, headers=HEADERS, timeout=20)
if r.status_code not in (429, 503):
r.raise_for_status()
return r.json()["data"]
# 429 ou 503 : attendre Retry-After, mais pas plus d'une minute
time.sleep(min(int(r.headers.get("Retry-After", "5")), 60))
raise RuntimeError("L'API n'a pas répondu après trois tentatives")
rows = []
for item in fetch_rates():
ex = [e for e in item["exchanges"]
if e["funding_8h_pct"] is not None]
if len(ex) < 2:
continue
short = max(ex, key=lambda e: e["funding_8h_pct"]) # jambe short
long_ = min(ex, key=lambda e: e["funding_8h_pct"]) # jambe long
spread = short["funding_8h_pct"] - long_["funding_8h_pct"]
rows.append((spread, item["coin"], short, long_))
rows.sort(key=lambda x: x[0], reverse=True)
for spread, coin, short, long_ in rows[:10]:
apr = spread * 3 * 365 # APR simple sur le notionnel d'une jambe
print(f"{coin:<10} short {short['exchange']:<8} "
f"long {long_['exchange']:<8} {spread:.4f}% par 8h "
f"APR {apr:.1f}%, sur le capital {apr / 2:.1f}%")
Le chiffre annualisé porte ici sur le notionnel d’une jambe. Les deux jambes exigent des fonds ; sur le capital total sans levier, le rendement est donc moitié moindre, comme dans le champ d’analytique apr_capital. Un exemple hypothétique : short sur un exchange à 0,05 % par 8 heures, long sur un autre à 0,01 %. Le spread est de 0,05 − 0,01 = 0,04 %, annualisé 0,04 × 3 × 365 = 43,8 % par jambe et 21,9 % sur le capital.
Les frais ne sont pas inclus. Un exemple hypothétique : des frais taker de 0,05 % sur chacune des quatre opérations (ouverture et clôture des deux jambes) font 4 × 0,05 = 0,2 % du notionnel d’une jambe. Un spread de 0,04 % les récupère en 0,2 / 0,04 = 5 règlements, soit 40 heures, si les taux ne bougent pas.
Seule une réponse 200 compte dans le quota. Dans un moniteur, n’interrogez pas plus d’une fois toutes les meta.freshness_sec secondes et envoyez l’ETag précédent dans If-None-Match : un ensemble complet inchangé revient sous la forme d’un 304 non facturé. Plus de détails dans le guide des limites et dans la leçon 4 du cours sur l’API crypto, qui construit un moniteur de spreads et de funding en Python.
Historique du funding versé : /funding/analytics/*
Le taux actuel montre le prochain règlement ; l’historique montre ce qui a réellement été versé. Il provient de quatre endpoints d’analytique : 13 exchanges, taux en pourcentage par période de règlement, horodatages en secondes epoch UTC. Ils sont disponibles sur les plans Pro (100 $ par mois) et Max (200 $) ; Trial et Start reçoivent 403 plan_restricted.
| Endpoint | Contenu | Section complète |
|---|---|---|
/funding/analytics/summary | Sommes, taux moyens sur 8 heures, APR et couverture pour 7 périodes, de 1 jour à un an | ~600 KB gzip |
/funding/analytics/recent | Tous les paiements des 7 derniers jours | ~1 MB gzip |
/funding/analytics/daily | Sommes quotidiennes sur 365 jours | jusqu’à ~12 MB gzip |
/funding/analytics/top | Top 50 des paires monnaie×exchange et top 50 des combinaisons short/long par période | — |
Les téléchargements complets sans coin sont limités : summary et recent une fois par 60 secondes, daily une fois par 300 secondes et par clé ; une requête avant la fin de la fenêtre reçoit 429 avec Retry-After. Les extraits par coin et les réponses 304 ne sont pas limités ; l’historique d’une monnaie s’obtient donc ainsi :
curl --compressed -G \
"https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
-d coin=BTC \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Dans summary, chaque paire monnaie×exchange porte l’intervalle interval_h, le début des données data_since, le dernier taux sur 8 heures last8h pour comparer « maintenant et la norme », et un tableau m de 14 métriques par période : sum, avg8h, apr, cov, flips et d’autres. Exemple de la documentation : BTC sur Binance sur 7 jours, 21 règlements positifs, avg8h 0,006298 %, apr 0,006298 × 3 × 365 ≈ 6,896 %. L’analyse de m, recent et daily est détaillée dans le guide des endpoints de funding, et les champs dans la section Analytique de funding de la documentation.
Le screener de combinaisons top
/funding/analytics/top est un screener prêt à l’emploi, sans paramètres. Les jambes des combinaisons s’y trouvent toujours sur des exchanges différents, avec une couverture d’au moins 0,9, et les combinaisons dont net ≤ 0 n’entrent jamais dans les listes.
gross est le funding brut de la combinaison sur la période, fees correspond aux frais de quatre opérations d’après la table taker_fees, et net = gross − fees. apr_net est annualisé sur le notionnel d’une jambe, apr_capital en est la moitié, sur le capital des deux jambes. win_rate est la part de jours gagnants, max_dd le plus fort drawdown, et price_div l’écart de prix actuel entre les jambes, que net ne prend pas en compte.
Dans l’exemple de la documentation, la combinaison PEPE (short sur HTX, long sur Hyperliquid sous le ticker 1000PEPE) a réalisé un gross de 1,51504 % avec des fees de 0,19 sur 7 jours. Ainsi net = 1,51504 − 0,19 = 1,32504 %, apr_net vaut 69,09 % et apr_capital 34,55 %. Listes prêtes à l’emploi : by_net_apr par rendement net, by_stable pour les combinaisons stables, by_live pour celles qui fonctionnent en ce moment.
Le taux de funding comme indicateur de marché
Avec un taux positif, les longs à effet de levier paient les shorts ; avec un taux négatif, c’est l’inverse. Un petit taux positif est normal (Hyperliquid fixe la composante d’intérêt à 0,01 % par 8 heures), et le taux devient un signal lorsqu’il s’écarte nettement de son niveau habituel.
Lisez un taux élevé avec l’open interest : quand les deux montent, beaucoup de positions à effet de levier sont empilées d’un même côté, et un mouvement contraire déclenche une cascade de liquidations. /market/open-interest renvoie l’open interest par exchange (section de la documentation). Plus de détails dans Le taux de funding comme indicateur de marché.
Risques de l’arbitrage de funding
Une combinaison short/long entre deux exchanges dépend à peine du prix, mais on peut tout de même y perdre de l’argent :
- le taux change avant le règlement et peut changer de signe, et seule une position ouverte au moment du règlement est payée ;
- les prix des jambes divergent : si le prix de l’exchange short est inférieur à celui de l’exchange long, l’entrée démarre dans le rouge ; vérifiez donc
priceouprice_div; - frais et slippage : il y a quatre opérations, et sur un carnet d’ordres peu profond l’entrée coûte plus cher que ne l’indique le tableau ;
- liquidation d’une jambe : la marge ne passe pas d’un exchange à l’autre, et la liquidation se déclenche sur le prix de marque (mark price) ;
- l’exchange peut modifier l’intervalle ou le plafond de taux d’un contrat ; sur Binance, ces contrats sont listés par
fundingInfo.
Sans code, les mêmes taux figurent dans le tableau Arbitrage de funding (guide), le calculateur de spread calcule une combinaison avec les frais, et l’aperçu des API crypto compare les API de données de marché en général.
Questions et réponses
Où trouver l’historique des taux de funding ?
Les exchanges conservent l’historique dans leurs propres formats : GET /fapi/v1/fundingRate chez Binance, GET /v5/market/funding/history chez Bybit, le type fundingHistory chez Hyperliquid. Genesis API renvoie l’historique de 13 exchanges dans un seul format : /funding/analytics/recent pour les paiements sur 7 jours, /funding/analytics/daily pour les sommes quotidiennes sur un an et /funding/analytics/summary pour les totaux par période, sur les plans Pro et Max.
Pourquoi les taux de funding diffèrent-ils selon les exchanges ?
Chaque exchange a ses propres traders, sa liquidité, sa formule de taux et ses plafonds ; le déséquilibre des positions se forme donc différemment. Les intervalles diffèrent aussi : 8 ou 4 heures sur les CEX, toutes les heures sur Hyperliquid. Comparez les taux après les avoir normalisés sur une même période ; dans Genesis API, c’est le champ funding_8h_pct.
À quelle fréquence les taux de funding sont-ils mis à jour dans l’API ?
Le taux actuel d’un exchange change jusqu’au règlement ; le taux réglé est figé et passe dans l’historique. La fraîcheur des données de Genesis API est de 60 s sur Trial, 30 s sur Start, 10 s sur Pro et 5 s sur Max ; l’ETag du summary d’analytique change environ toutes les 15 minutes, et les sommes quotidiennes sont recalculées chaque heure.
Existe-t-il une API de funding rate gratuite ?
Genesis API n’a pas de plan gratuit : les taux de funding et le spread sont dans Trial à 20 $ par mois, l’historique dans Pro à 100 $ et Max à 200 $. Sur le site, les taux de funding et les spreads sont visibles sans plan dans Arbitrage de funding.