Endpoints funding de Genesis API : taux, spread et analytique de l’historique de funding
En bref
/funding/rateset/funding/spreadsont dans tous les plans de l’API : le taux de chaque exchange par intervalle et sur 8 heures, l’heure du prochain paiement et la meilleure paire d’exchanges par spread.- L’analytique du funding réglé, ce sont quatre endpoints
/funding/analytics/…sur 13 exchanges avec jusqu’à un an d’historique, dans les plans Pro et Max. - Les téléchargements complets de summary, recent et daily pèsent jusqu’à ~12 Mo en gzip et sont permis une fois toutes les 60–300 secondes : prenez une tranche
coinou répétez la requête avecIf-None-Match.
L’API de taux de funding de Genesis API est un ensemble d’endpoints avec les taux de funding des contrats perpétuels sur plusieurs exchanges, la meilleure paire d’exchanges par spread de funding et l’historique du funding réglé. Les taux actuels et le spread sont dans tous les plans de l’API ; l’analytique historique de 13 exchanges, dans Pro et Max. Le site montre les mêmes données dans Funding Arbitrage, voir le guide.
Endpoints funding et plans
| Endpoint | Ce qu’il renvoie | Plans de l’API |
|---|---|---|
/funding/rates | Taux de chaque exchange pour chaque coin | Trial, Start, Pro, Max |
/funding/spread | La meilleure paire d’exchanges par spread et les autres exchanges | Trial, Start, Pro, Max |
/funding/analytics/summary | Synthèse sur des périodes de 1 jour à un an | Pro, Max |
/funding/analytics/recent | Tous les paiements sur 7 jours | Pro, Max |
/funding/analytics/daily | Sommes quotidiennes sur 365 jours | Pro, Max |
/funding/analytics/top | Screener de paires et de combinaisons d’exchanges | Pro, Max |
Les paramètres et les champs figurent dans les sections de la documentation Taux de funding, Spread de funding et Funding analytics. Sur Trial et Start, les endpoints d’analytique renvoient 403 plan_restricted. Pour un panorama des API de données de funding, voir l’article sur l’API de taux de funding. Les exemples de réponse ci-dessous montrent le champ data, abrégé.
Taux et normalisation à 8 heures
/funding/rates renvoie, pour chaque coin, la liste des exchanges avec le taux actuel. Les filtres coin et exchange (séparés par des virgules pour plusieurs exchanges) sont optionnels.
curl "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"
}
]
}
| Champ | Signification |
|---|---|
funding_pct | Taux par intervalle de règlement, % |
funding_8h_pct | Taux ramené à 8 heures, % |
interval | Intervalle de règlement, p. ex. 8h ; null : pas de données |
next_payout | Heure du prochain paiement, HH:MM UTC ; null : pas de données |
price, trade_url | Prix et lien vers le terminal de trading de l’exchange |
Un exemple hypothétique : un taux horaire de 0,005 % donne 0,005 × 8 / 1 = 0,04 % sur 8 heures, comme MEXC, sauf qu’il paie huit fois et peut changer dès l’heure suivante.
Annualisé sans capitalisation, le taux sur 8 heures × 3 × 365 donne l’APR. Un exemple hypothétique : 0,01 % toutes les 8 heures donne 0,01 × 3 × 365 = 10,95 % par an, tant que le taux tient. Ce que le taux dit du marché est expliqué dans Le taux de funding comme indicateur de marché.
Spread de funding : la meilleure paire d’exchanges
/funding/spread renvoie, pour chaque coin, la meilleure paire d’exchanges par spread de funding (best) et les autres exchanges (others). Filtres : coin et min_spread, le spread minimal en %.
{
"coin": "BTC",
"spread_pct": 0.01,
"best": {
"exchange_1": "Hyper",
"exchange_2": "CoinEx",
"funding_1_pct": 0.0,
"funding_2_pct": 0.0,
"next_payout_1": null,
"next_payout_2": "08:00",
"interval_1": "1h",
"interval_2": "8h",
"trade_url_1": "https://app.hyperliquid.xyz/trade/BTC",
"trade_url_2": "https://www.coinex.com/futures/BTC-usdt"
},
"others": [ … ]
}
spread_pct est le spread de la meilleure paire, %. funding_1_pct et funding_2_pct sont des taux par leur propre intervalle (interval_1, interval_2) : pour les comparer à la main, ramenez les deux à 8 heures. Le short va là où le taux est le plus élevé, le long là où il est le plus bas. Hyperliquid apparaît sous le nom Hyper dans les réponses.
Le script Python affiche les dix coins avec le spread_pct le plus élevé (à partir de 0,05 %) et les intervalles de règlement de la paire. Sur 429 et 503, il attend Retry-After secondes ; dans une boucle, répétez la requête au plus une fois par meta.freshness_sec.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/spread"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
for _ in range(3):
r = requests.get(URL, headers=HEADERS,
params={"min_spread": 0.05}, timeout=15)
if r.status_code not in (429, 503):
break
# rate limit ou données en reconstruction : attendre et réessayer
time.sleep(int(r.headers.get("Retry-After", "5")))
r.raise_for_status()
rows = sorted(r.json()["data"], key=lambda x: x["spread_pct"],
reverse=True)
for row in rows[:10]:
b = row["best"]
print(f'{row["coin"]:<10} {row["spread_pct"]:>8.4f}% '
f'{b["exchange_1"]} {b["interval_1"]} / '
f'{b["exchange_2"]} {b["interval_2"]}')
Analytique du funding réglé
Quatre endpoints /funding/analytics/… renvoient l’historique du funding réglé sur 13 exchanges, les mêmes données que l’onglet Analytique de Funding Arbitrage. Les taux sont en pourcentage par période de règlement, les horodatages en secondes epoch UTC.
| Endpoint | Contenu | Section complète | Sans coin, au plus |
|---|---|---|---|
/funding/analytics/summary | Sommes, taux moyens, APR et couverture pour 7 périodes | ~600 Ko gzip | une fois par 60 s |
/funding/analytics/recent | Tous les paiements sur 7 jours | ~1 Mo gzip | une fois par 60 s |
/funding/analytics/daily | Sommes quotidiennes sur 365 jours | jusqu’à ~12 Mo gzip | une fois par 300 s |
/funding/analytics/top | Top 50 des paires et top 50 des combinaisons par période | — | sans limite |
Un téléchargement complet avant la fin de la fenêtre reçoit 429 avec Retry-After. Les règles d’ETag et de compression sont dans le guide format de réponse et erreurs.
curl --compressed -i \
"https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-H "If-None-Match: <ETag from the previous response>"
--compressed demande une réponse compressée et la décompresse, et -i affiche les en-têtes, dont ETag. Envoyez la première requête sans If-None-Match.
Le summary et le tableau m
Chaque paire coin×exchange du summary a m : la clé est une période (1d, 3d, 7d, 30d, 90d, 180d, 365d), la valeur est 14 nombres dans l’ordre de metric_order. Une période est absente de m quand il n’y a aucune donnée pour elle.
{
"metric_order": ["sum", "avg8h", "apr", "n", "pos", "neg", "zero",
"min", "max", "cov", "med8h", "pos_streak",
"neg_streak", "flips"],
"coins": {
"BTC": {
"canon": "BTC",
"mult": 1,
"exchanges": {
"Binance": {
"interval_h": 8.0,
"data_since": 1568102400,
"last8h": 0.004123,
"m": {
"7d": [0.12802, 0.006298, 6.896, 21, 21, 0, 0,
0.000125, 0.01, 1.0, 0.00588, 7, 0, 0]
}
}
}
}
}
}
| Métrique | Indice | Signification |
|---|---|---|
sum | 0 | Cumul sur la période, % |
avg8h | 1 | Taux moyen en équivalent 8 heures, % |
apr | 2 | Annualisé, % |
n | 3 | Nombre de règlements |
pos, neg, zero | 4–6 | Règlements positifs, négatifs et nuls |
min, max | 7–8 | Plus petit et plus grand règlement, % |
cov | 9 | Couverture de la période de 0 à 1 |
med8h | 10 | Médiane en équivalent 8 heures, % |
pos_streak, neg_streak | 11–12 | Jours de suite positifs et négatifs |
flips | 13 | Changements de signe |
Les indices 10–13 valent null pour les périodes 1d et 3d. Avec cov < 0,9, les données ne couvrent qu’une partie de la période : signalez ces valeurs. Dans l’exemple, BTC sur Binance sur 7 jours : 21 règlements, tous positifs, cov 1,0, et apr est égal à avg8h × 3 × 365 : 0,006298 × 1095 ≈ 6,896.
Si avg8h est nettement au-dessus de med8h, un pic a gonflé la moyenne : la médiane, pos_streak et flips montrent mieux la stabilité. Les autres champs de la paire :
data_since: début des données ; ne tracez pas de zéros avant cette date.last8h: le dernier taux en équivalent 8 heures, pour comparer « maintenant et la norme ».interval_h: intervalle de règlement : 8 ou 4 heures sur les CEX, 1 heure sur Hyperliquid et Lighter.canonetmult: le nom qui regroupe les variantes de ticker (1000PEPE→PEPE) et le multiplicateur du contrat ;multne s’applique jamais aux taux.
Paiements sur 7 jours et sommes quotidiennes
Dans /funding/analytics/recent, chaque exchange a une chaîne s de la forme ts:rate;ts:rate;… en ordre croissant du temps et un intervalle i en heures. Dans /funding/analytics/daily, la chaîne day_ts:sum:pos:neg;… contient minuit UTC, la somme du jour et le nombre de règlements positifs et négatifs.
def parse_recent(s):
# "ts:rate;ts:rate;…" → [(ts, rate), …]
return [(int(t), float(v)) for t, v in
(p.split(":") for p in s.split(";") if p)]
def parse_daily(s):
# "day_ts:sum:pos:neg;…" → [(day, sum, positive, negative), …]
out = []
for p in filter(None, s.split(";")):
d, total, pos, neg = p.split(":")
out.append((int(d), float(total), int(pos), int(neg)))
return out
Screener de combinaisons
/funding/analytics/top est un screener prêt à l’emploi, sans paramètres : pour chaque période, le top 50 des paires coin×exchange par funding cumulé et le top 50 des combinaisons short/long. Les jambes d’une combinaison sont toujours sur des exchanges différents, avec une couverture d’au moins 0,9, et les lignes avec net ≤ 0 n’apparaissent jamais.
by_net_apr: par rendement net.by_stable:win_rate≥ 0,7 et un drawdown au plus égal à la moitié du brut.by_live:live_8h> 0 ettrend_1d> 0.by_sum_pos,by_sum_neg: tops à un seul exchange par funding cumulé, uniquement aveccov≥ 0,5.
| Champ de la combinaison | Signification |
|---|---|
gross, fees, net | Funding brut, les frais de quatre transactions selon taker_fees et net = gross − fees |
apr_net, apr_capital | Annualisé sur le notionnel d’une jambe, et apr_net / 2 sur le capital des deux jambes |
win_rate, max_dd | Part des jours gagnants (0..1) et le drawdown maximal du résultat cumulé |
worst_streak, risk_days | La plus longue série de jours perdants et les jours sur lesquels le risque a été mesuré, max 90 |
live_8h, trend_1d, trend_7d | L’écart actuel de taux sur 8 heures et le spread brut du dernier jour et de la dernière semaine |
price_div | L’écart de prix actuel entre les jambes ; null si les prix sont indisponibles |
short_sym, long_sym | Tickers réels des jambes sur les exchanges, qui peuvent différer : PEPE et 1000PEPE |
Dans l’exemple de la documentation, la combinaison PEPE, short sur HTX et long sur Hyperliquid, a obtenu un gross de 1,51504 % sur 7 jours. Les frais sont de 0,05 % à l’ouverture et à la clôture sur HTX et de 0,045 % pour chacune sur Hyperliquid : 0,05 × 2 + 0,045 × 2 = 0,19.
Ainsi net = 1,51504 − 0,19 = 1,32504 %, apr_net = 1,32504 × 365 / 7 ≈ 69,09 %, apr_capital = 69,09 / 2 ≈ 34,55 %. L’écart de prix entre les jambes, le slippage et la marge ne sont pas inclus.
Comment construire un moniteur de funding
Trouvez des candidats
Demandez
/funding/spreadavecmin_spread(n’importe quel plan de l’API) et triez parspread_pct.Vérifiez les taux et les paiements
Demandez
/funding/ratesaveccoin:interval,next_payoutetfunding_8h_pctsur les deux exchanges. La position doit être ouverte à l’heure du règlement.Regardez l’historique
Sur Pro et Max, demandez
/funding/analytics/summaryaveccoin:sum,apr,covetflipssur 7d et 30d montrent si l’écart de taux tient.Évaluez la combinaison dans son ensemble
Dans
/funding/analytics/top, compareznet,apr_capital,win_rate,max_ddet leprice_divactuel.Ouvrez les positions vous-même
Les liens
trade_urlmènent aux terminaux des exchanges ; chiffrez la combinaison avec les frais dans le calculateur de spread.
Questions et réponses
Comment ramener un taux de funding à 8 heures ?
Multipliez le taux par intervalle par 8 et divisez par la durée de l’intervalle en heures. /funding/rates le fait pour vous dans le champ funding_8h_pct.
Où trouver l’historique des taux de funding ?
/funding/analytics/recent contient tous les paiements sur 7 jours, /funding/analytics/daily les sommes quotidiennes sur un an et /funding/analytics/summary les totaux par période. Les trois sont dans les plans API Pro et Max.
Pourquoi une section complète d’analytique renvoie-t-elle 429 ?
Les téléchargements complets sans coin sont limités : summary et recent une fois par 60 secondes, daily une fois par 300 secondes par clé. Les tranches par coin et les réponses 304 à If-None-Match ne sont pas limitées.