Genesis Arbitrage

Genesis Arbitrage · · 13 min de lecture

Données de marché Genesis API : Fair – Last, pumps, OI, signaux IA, recherche

En bref

  • Six endpoints de marché reprennent le site : Fair – Last, CEX Pumps – Dumps, DEX Dumps, OI Tracking, signaux Genesis AI+ et recherche de coins. Tous, sauf DEX Dumps, sont disponibles dès le plan Trial.
  • Les variations de prix et d’open interest arrivent en pourcentages déjà calculés, sur des intervalles de 5 secondes à une heure : inutile de stocker votre propre historique pour les obtenir.
  • Genesis API ne fait que lire les données. Elle montre les mouvements et les anomalies ; la décision de trader et l’ordre sur l’exchange restent les vôtres.

Les endpoints de marché de Genesis API renvoient les mêmes données que les sections Fair – Last, CEX Pumps – Dumps, DEX Dumps et OI Tracking du site, ainsi que le flux de signaux Genesis AI+ et une fiche de coin sur tous les exchanges. Chaque appel est un HTTP GET avec la clé dans l’en-tête X-API-Key et une réponse dans l’enveloppe data et meta. Les développeurs utilisent ces données pour des alertes de mouvements brusques, des moniteurs d’open interest et des vérifications d’un coin avant de trader.

Endpoints et plans

EndpointCe qu’il renvoiePlans API
/market/fair-pricePrix mark et dernier prix échangéTrial, Start, Pro, Max
/market/pumpsPumps et dumps sur CEXTrial, Start, Pro, Max
/market/dex-dumpsEffondrements de tokens sur DEXPro, Max
/market/open-interestOpen interest par exchangeTrial, Start, Pro, Max
/ai/signalsSignaux Genesis AI+Trial, Start, Pro, Max
/coins/searchFiche d’un coin sur tous les exchangesTrial, Start, Pro, Max

L’URL de base est https://api.genesisarbitrage.com/v1, et un endpoint hors de votre plan renvoie 403 plan_restricted. Le plan fixe aussi la fraîcheur des données : 60 s sur Trial, 30 s sur Start, 10 s sur Pro et 5 s sur Max. La clé et la première requête sont décrites dans le démarrage rapide, les quotas dans les limites de Genesis API et les codes d’erreur dans les réponses et erreurs de Genesis API.

Fair – Last : /market/fair-price

Chaque ligne correspond aux futures d’un coin sur un exchange : le prix mark (Fair), le prix de la dernière transaction (Last) et l’écart entre les deux. Le prix mark est calculé, et sur Binance Futures la liquidation se déclenche sur lui. Un écart large signifie que des transactions sur un exchange ont poussé Last, ou que le carnet d’ordres n’avait plus d’ordres. La façon d’examiner ces lignes est décrite dans le guide Fair – Last, les champs dans la documentation.

ParamètreTypeRôle
exchangestringExchange ; plusieurs séparés par des virgules
coinstringTicker du coin, par ex. BTC
min_spreadnumberÉcart absolu minimal, %
ChampTypeSignification
fair_price / last_pricenumberPrix mark et prix de la dernière transaction
spread_pctnumberÉcart entre les deux, %
fair_changes / last_changesobjectVariation de chaque prix, % : s5, s10, s30 et m1, sur 5, 10 et 30 secondes et une minute
curl -G "https://api.genesisarbitrage.com/v1/market/fair-price" \
  -d exchange=ByBit \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

L’option -G place les paramètres -d dans l’URL de la requête. La réponse est un tableau data ; ici et plus bas, nous montrons l’un de ses éléments :

{
  "exchange": "ByBit",
  "coin": "0G",
  "fair_price": 0.192,
  "last_price": 0.192,
  "spread_pct": 0.0,
  "trade_url": "https://www.bybit.com/trade/usdt/0GUSDT",
  "fair_changes": { "s5": 0.0, "s10": 0.052, "s30": 0.052, "m1": 0.0 },
  "last_changes": { "s5": 0.052, "s10": 0.052, "s30": 0.052, "m1": 0.0 }
}

CEX Pumps – Dumps : /market/pumps

L’endpoint reprend le tableau CEX Pumps – Dumps : le prix d’un coin sur les futures d’un exchange et sa variation sur huit intervalles, dans les champs change_5s, change_10s, change_30s, change_60s, change_5m, change_15m, change_30m et change_1h. Une requête avec min_change=5 garde les coins qui ont bougé de 5 % ou plus, dans un sens ou dans l’autre, sur au moins un intervalle. Tous les champs sont dans la documentation de l’endpoint.

ParamètreTypeRôle
exchangestringExchange ; plusieurs séparés par des virgules
coinstringTicker du coin
min_changenumberSeuil absolu de variation de prix, %
ChampTypeSignification
pricenumberPrix actuel
change_5s … change_1hnumberVariation du prix sur l’intervalle, %
volume_24hnumberVolume sur 24 h, USD
funding_pctnumber ou nullTaux de financement (funding) par période de règlement, %
contract / networkstring ou nullAdresse du contrat et réseau du token
curl -G "https://api.genesisarbitrage.com/v1/market/pumps" \
  -d coin=BTC -d exchange=MEXC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "exchange": "MEXC",
  "coin": "BTC",
  "price": 64267.9,
  "change_5s": 0.0,
  "change_10s": 0.0,
  "change_30s": 0.02,
  "change_60s": 0.06,
  "change_5m": 0.08,
  "change_15m": -0.06,
  "change_30m": -0.09,
  "change_1h": -0.2,
  "volume_24h": 2243246205,
  "funding_pct": 0.01,
  "network": "BNB Smart Chain(BEP20)",
  "trade_url": "https://futures.mexc.com/exchange/BTC_USDT"
}

DEX Dumps : /market/dex-dumps

Plans Pro et Max. L’endpoint renvoie les effondrements de tokens sur DEX, comme la section DEX Dumps, avec la liquidité du pool et un indicateur précisant si le token se négocie sur CEX. Le schéma de la réponse est dans la documentation.

ParamètreTypeRôle
chainstringRéseau, par ex. bsc
min_liquiditynumberLiquidité minimale du pool, USD
ChampTypeSignification
tsintHeure de l’événement, secondes unix
price / liquidity_usdnumberPrix et liquidité du pool, USD
market_capnumber ou nullCapitalisation, USD
price_changesobjectVariation de prix, % : m5, h1, h6 et h24
listed_on_cexbooleanSi le coin se négocie sur CEX
cex_spot / cex_futuresstring[]Exchanges proposant le spot et les futures du coin
pool_urlstringLien du pool
curl -G "https://api.genesisarbitrage.com/v1/market/dex-dumps" \
  -d chain=bsc -d min_liquidity=20000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "ts": 1783203653,
  "coin": "ONLY",
  "chain": "bsc",
  "price": 0.00009884,
  "liquidity_usd": 30477.58,
  "market_cap": 98840,
  "price_changes": {
    "m5": -58.03, "h1": 31.83, "h6": 31.83, "h24": 31.83
  },
  "pool_url": "https://dexscreener.com/bsc/0x2a18…",
  "listed_on_cex": false,
  "cex_spot": [],
  "cex_futures": []
}

OI Tracking : /market/open-interest

L’open interest (OI) est le volume de positions de futures ouvertes et pas encore clôturées. L’endpoint le renvoie comme le tableau OI Tracking : le total du coin dans total et le détail par exchange dans exchanges. Les données couvrent plus de 13 exchanges de futures, dont Binance, Bybit, OKX, Bitget et Gate. Un aperçu figure dans l’article sur l’API open interest, les champs dans la documentation.

ParamètreTypeRôle
coinstringTicker du coin
exchangestringExchange ; plusieurs séparés par des virgules
ChampTypeSignification
total.oi_usd / total.oi_tokensnumberOpen interest en dollars et en coins
total.avg_pricenumberPrix moyen pondéré par le volume sur les exchanges
total.volume_24hnumberVolume sur 24 h, USD
total.oi_change_5m/15m/30m/1hnumberVariation de l’OI sur l’intervalle, %
total.price_change_5m/15m/30m/1hnumberVariation du prix sur l’intervalle, %
exchanges{}objectLes mêmes métriques par exchange : price à la place de avg_price, plus trade_url
curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
  -d coin=GRAM \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "GRAM",
  "total": {
    "oi_usd": 96544685.3,
    "oi_tokens": 58105803.3,
    "avg_price": 1.661224,
    "volume_24h": 47010004.63,
    "oi_change_1h": 0.3185,
    "price_change_1h": -0.1929,
    …
  },
  "exchanges": {
    "ByBit": {
      "price": 1.6609,
      "oi_usd": 26838489.41,
      "oi_change_1h": -0.097,
      "trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
      …
    }
  }
}

Exemple hypothétique : OI en hausse de plus de 5 % sur une heure, avec le prix

Vous cherchez les coins qui ont attiré de nouvelles positions sur la dernière heure pendant que le prix montait : total.oi_change_1h supérieur à 5 et total.price_change_1h supérieur à 0. Les deux champs sont déjà en pourcentage.

Il y a une heure, le coin A avait 40 000 000 $ d’OI, il en a maintenant 42 600 000 $ : (42 600 000 − 40 000 000) / 40 000 000 × 100 = 6,5 %. Sur la même heure, le prix est passé de 2,00 $ à 2,056 $ : (2,056 − 2,00) / 2,00 × 100 = 2,8 %. Dans la réponse, cela donne oi_change_1h: 6.5 et price_change_1h: 2.8.

CoinOI, 1 hPrix, 1 hRésultat
A+6,5 %+2,8 %Retenu
B+7,2 %−1,9 %Non : l’OI monte à contre-courant du prix
C+3,1 %+4,0 %Non : OI sous le seuil

Pour le coin B, l’OI monte alors que le prix baisse, ce qui signifie généralement que des shorts s’ouvrent. Un OI qui monte avec le prix ne promet pas la poursuite du mouvement : un marché surchauffé peut se retourner en cascade de liquidations.

  1. Demander l’instantané complet

    Un appel sans filtres renvoie tous les coins.

  2. Écarter les petits coins

    Fixez un seuil sur total.oi_usd, par ex. 5 000 000 $ : avec un petit OI, quelques grosses positions produisent un pourcentage énorme.

  3. Appliquer la condition

    oi_change_1h supérieur à 5, price_change_1h supérieur à 0.

  4. Vérifier l’ampleur du mouvement

    Comptez les exchanges de exchanges où l’OI a aussi progressé de plus de 5 % : une hausse sur plusieurs plateformes pèse davantage.

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  # ignorer les petits coins

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

for row in get("/market/open-interest"):
    t = row["total"]
    oi, price = t.get("oi_change_1h"), t.get("price_change_1h")
    if oi is None or price is None:
        continue
    if (t.get("oi_usd") or 0) < MIN_OI_USD:
        continue
    if oi > 5 and price > 0:
        wide = [ex for ex, m in row["exchanges"].items()
                if (m.get("oi_change_1h") or 0) > 5]
        print(f"{row['coin']}: OI {oi:+.1f}%, prix {price:+.1f}%, "
              f"exchanges avec hausse de l'OI: {len(wide)}")

Signaux Genesis AI+ : /ai/signals

Genesis AI+ vérifie les signaux d’arbitrage et note chacun de alpha à noise. L’endpoint renvoie ce flux avec le texte en russe et en anglais et des liens vers les plateformes. category n’accepte qu’une seule valeur : pour alpha et high, faites deux requêtes ou filtrez la réponse de votre côté. Les descriptions des champs sont dans la documentation.

ParamètreTypeRôle
categorystringNote : alpha, high, middle, risky ou noise
coinstringTicker du coin
ChampTypeSignification
idstringIdentifiant : votre bot l’utilise pour ignorer les doublons
ts / timeint / stringHeure : secondes unix et ISO 8601
pipelinestringSource du signal
message_ru / message_enstring ou nullTexte du signal en russe et en anglais
linksarrayLiens prêts à l’emploi : texte + url
curl -G "https://api.genesisarbitrage.com/v1/ai/signals" \
  -d coin=UTYA \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "id": "1783198680493",
  "ts": 1783198680,
  "time": "2026-07-04T20:58:00Z",
  "coin": "UTYA",
  "pipeline": "public",
  "category": "noise",
  "message_ru": "Глянул на UTYA — DEX против MEXC Futures…",
  "message_en": "Checked UTYA — DEX against MEXC Futures…",
  "links": [
    {
      "text": "MEXC Futures",
      "url": "https://futures.mexc.com/exchange/UTYA_USDT"
    }
  ]
}

Recherche de coins : /coins/search

L’endpoint renvoie une fiche de coin, comme Coin Search sur le site : contrats par réseau, prix spot et futures, statut des dépôts et retraits sur chaque exchange et résumé du funding. Le ticker se passe dans le paramètre obligatoire query, et un coin inconnu renvoie 404 not_found. Ici data est un objet unique. Les champs sont dans la documentation.

ChampTypeSignification
contracts[]arrayContrats : adresse, réseau et exchanges qui l’utilisent
exchanges{}.spot_price / futures_pricenumber ou nullPrix spot et futures ; null signifie qu’il n’y a pas de marché
exchanges{}.deposit / withdrawboolean ou nullSi les dépôts et les retraits sont ouverts
fundingobject ou nullRésumé du funding ; null signifie qu’il n’y a pas de futures

Un même ticker peut désigner des tokens différents selon l’exchange : avant un transfert, comparez l’adresse de contracts[] avec le contrat affiché sur la page de dépôt de l’exchange.

curl -G "https://api.genesisarbitrage.com/v1/coins/search" \
  -d query=IRYS \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "IRYS",
  "contracts": [
    {
      "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
      "network": "BNB Smart Chain(BEP20)",
      "exchanges": ["MEXC", "Ourbit"]
    }
  ],
  "exchanges": {
    "MEXC": {
      "spot_price": 0.01329,
      "futures_price": 0.0133,
      "deposit": true,
      "withdraw": true,
      "spot_url": "https://www.mexc.com/exchange/IRYS_USDT",
      …
    }
  },
  "funding": {
    "spread_pct": 0.0,
    "best": { "exchange_1": "Bitget", "exchange_2": "OKX", … }
  }
}

Questions et réponses

Quels endpoints de marché sont sur le plan Trial ?

Tous sauf DEX Dumps : cet endpoint est ouvert sur Pro et Max et renvoie 403 plan_restricted sur Trial et Start.

L’API propose-t-elle un historique de l’open interest ?

Non : l’endpoint renvoie l’instantané actuel avec les variations sur 5, 15 et 30 minutes et une heure, et Genesis API n’a pas de bougies historiques. Constituez l’historique vous-même en stockant les réponses.

Puis-je ouvrir des trades via ces endpoints ?

Non. Genesis API ne fait que lire les données et ne passe aucun ordre : vous ouvrez le trade vous-même sur l’exchange.

À quelle fréquence interroger les endpoints de marché ?

Pas plus souvent que meta.freshness_sec : de 60 s sur Trial à 5 s sur Max. Une réponse sans filtres porte un en-tête ETag. Renvoyez-le dans If-None-Match : tant que les données n’ont pas changé, le serveur répond 304, qui ne consomme pas votre quota.