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
| Endpoint | Ce qu’il renvoie | Plans API |
|---|---|---|
/market/fair-price | Prix mark et dernier prix échangé | Trial, Start, Pro, Max |
/market/pumps | Pumps et dumps sur CEX | Trial, Start, Pro, Max |
/market/dex-dumps | Effondrements de tokens sur DEX | Pro, Max |
/market/open-interest | Open interest par exchange | Trial, Start, Pro, Max |
/ai/signals | Signaux Genesis AI+ | Trial, Start, Pro, Max |
/coins/search | Fiche d’un coin sur tous les exchanges | Trial, 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ètre | Type | Rôle |
|---|---|---|
exchange | string | Exchange ; plusieurs séparés par des virgules |
coin | string | Ticker du coin, par ex. BTC |
min_spread | number | Écart absolu minimal, % |
| Champ | Type | Signification |
|---|---|---|
fair_price / last_price | number | Prix mark et prix de la dernière transaction |
spread_pct | number | Écart entre les deux, % |
fair_changes / last_changes | object | Variation 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ètre | Type | Rôle |
|---|---|---|
exchange | string | Exchange ; plusieurs séparés par des virgules |
coin | string | Ticker du coin |
min_change | number | Seuil absolu de variation de prix, % |
| Champ | Type | Signification |
|---|---|---|
price | number | Prix actuel |
change_5s … change_1h | number | Variation du prix sur l’intervalle, % |
volume_24h | number | Volume sur 24 h, USD |
funding_pct | number ou null | Taux de financement (funding) par période de règlement, % |
contract / network | string ou null | Adresse 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ètre | Type | Rôle |
|---|---|---|
chain | string | Réseau, par ex. bsc |
min_liquidity | number | Liquidité minimale du pool, USD |
| Champ | Type | Signification |
|---|---|---|
ts | int | Heure de l’événement, secondes unix |
price / liquidity_usd | number | Prix et liquidité du pool, USD |
market_cap | number ou null | Capitalisation, USD |
price_changes | object | Variation de prix, % : m5, h1, h6 et h24 |
listed_on_cex | boolean | Si le coin se négocie sur CEX |
cex_spot / cex_futures | string[] | Exchanges proposant le spot et les futures du coin |
pool_url | string | Lien 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ètre | Type | Rôle |
|---|---|---|
coin | string | Ticker du coin |
exchange | string | Exchange ; plusieurs séparés par des virgules |
| Champ | Type | Signification |
|---|---|---|
total.oi_usd / total.oi_tokens | number | Open interest en dollars et en coins |
total.avg_price | number | Prix moyen pondéré par le volume sur les exchanges |
total.volume_24h | number | Volume sur 24 h, USD |
total.oi_change_5m/15m/30m/1h | number | Variation de l’OI sur l’intervalle, % |
total.price_change_5m/15m/30m/1h | number | Variation du prix sur l’intervalle, % |
exchanges{} | object | Les 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.
| Coin | OI, 1 h | Prix, 1 h | Ré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.
Demander l’instantané complet
Un appel sans filtres renvoie tous les coins.
É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.Appliquer la condition
oi_change_1hsupérieur à 5,price_change_1hsupérieur à 0.Vérifier l’ampleur du mouvement
Comptez les exchanges de
exchangesoù 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ètre | Type | Rôle |
|---|---|---|
category | string | Note : alpha, high, middle, risky ou noise |
coin | string | Ticker du coin |
| Champ | Type | Signification |
|---|---|---|
id | string | Identifiant : votre bot l’utilise pour ignorer les doublons |
ts / time | int / string | Heure : secondes unix et ISO 8601 |
pipeline | string | Source du signal |
message_ru / message_en | string ou null | Texte du signal en russe et en anglais |
links | array | Liens 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.
| Champ | Type | Signification |
|---|---|---|
contracts[] | array | Contrats : adresse, réseau et exchanges qui l’utilisent |
exchanges{}.spot_price / futures_price | number ou null | Prix spot et futures ; null signifie qu’il n’y a pas de marché |
exchanges{}.deposit / withdraw | boolean ou null | Si les dépôts et les retraits sont ouverts |
funding | object ou null | Ré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.