Genesis Arbitrage

Genesis Arbitrage · · 12 min de lecture

Endpoints funding de Genesis API : taux, spread et analytique de l’historique de funding

En bref

  • /funding/rates et /funding/spread sont 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 coin ou répétez la requête avec If-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

EndpointCe qu’il renvoiePlans de l’API
/funding/ratesTaux de chaque exchange pour chaque coinTrial, Start, Pro, Max
/funding/spreadLa meilleure paire d’exchanges par spread et les autres exchangesTrial, Start, Pro, Max
/funding/analytics/summarySynthèse sur des périodes de 1 jour à un anPro, Max
/funding/analytics/recentTous les paiements sur 7 joursPro, Max
/funding/analytics/dailySommes quotidiennes sur 365 joursPro, Max
/funding/analytics/topScreener de paires et de combinaisons d’exchangesPro, 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"
    }
  ]
}
ChampSignification
funding_pctTaux par intervalle de règlement, %
funding_8h_pctTaux ramené à 8 heures, %
intervalIntervalle de règlement, p. ex. 8h ; null : pas de données
next_payoutHeure du prochain paiement, HH:MM UTC ; null : pas de données
price, trade_urlPrix 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.

EndpointContenuSection complèteSans coin, au plus
/funding/analytics/summarySommes, taux moyens, APR et couverture pour 7 périodes~600 Ko gzipune fois par 60 s
/funding/analytics/recentTous les paiements sur 7 jours~1 Mo gzipune fois par 60 s
/funding/analytics/dailySommes quotidiennes sur 365 joursjusqu’à ~12 Mo gzipune fois par 300 s
/funding/analytics/topTop 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étriqueIndiceSignification
sum0Cumul sur la période, %
avg8h1Taux moyen en équivalent 8 heures, %
apr2Annualisé, %
n3Nombre de règlements
pos, neg, zero4–6Règlements positifs, négatifs et nuls
min, max7–8Plus petit et plus grand règlement, %
cov9Couverture de la période de 0 à 1
med8h10Médiane en équivalent 8 heures, %
pos_streak, neg_streak11–12Jours de suite positifs et négatifs
flips13Changements 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 :

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.

Champ de la combinaisonSignification
gross, fees, netFunding brut, les frais de quatre transactions selon taker_fees et net = gross − fees
apr_net, apr_capitalAnnualisé sur le notionnel d’une jambe, et apr_net / 2 sur le capital des deux jambes
win_rate, max_ddPart des jours gagnants (0..1) et le drawdown maximal du résultat cumulé
worst_streak, risk_daysLa plus longue série de jours perdants et les jours sur lesquels le risque a été mesuré, max 90
live_8h, trend_1d, trend_7dL’écart actuel de taux sur 8 heures et le spread brut du dernier jour et de la dernière semaine
price_divL’écart de prix actuel entre les jambes ; null si les prix sont indisponibles
short_sym, long_symTickers 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

  1. Trouvez des candidats

    Demandez /funding/spread avec min_spread (n’importe quel plan de l’API) et triez par spread_pct.

  2. Vérifiez les taux et les paiements

    Demandez /funding/rates avec coin : interval, next_payout et funding_8h_pct sur les deux exchanges. La position doit être ouverte à l’heure du règlement.

  3. Regardez l’historique

    Sur Pro et Max, demandez /funding/analytics/summary avec coin : sum, apr, cov et flips sur 7d et 30d montrent si l’écart de taux tient.

  4. Évaluez la combinaison dans son ensemble

    Dans /funding/analytics/top, comparez net, apr_capital, win_rate, max_dd et le price_div actuel.

  5. Ouvrez les positions vous-même

    Les liens trade_url mè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.