Genesis Arbitrage

Genesis Arbitrage · · 3 min de lecture

JSON

JSON (JavaScript Object Notation) est un format texte d’échange de données où les valeurs sont regroupées en objets entre accolades et en tableaux entre crochets. Il est défini par la RFC 8259 et la norme ECMA-404, et son type de média est application/json. Genesis API répond aussi en JSON.

Types de valeurs

TypeExempleEn Python
Objet{"coin": "BTC"}dict
Tableau[0.11, 0.45]list
Chaîne"ByBit"str
Nombre214, 0.92int, float
Booléentrue, falseTrue, False
Valeur videnullNone

Les noms de champs et les chaînes n’acceptent que les guillemets doubles. JSON n’a pas de commentaires, et une virgule après le dernier élément rend le document invalide.

Une réponse de Genesis API

Exemple hypothétique d’une réponse de l’endpoint /arbitrage/spot-spot : une ligne, certains champs omis.

{
  "success": true,
  "data": [
    {
      "coin": "FUEL",
      "exchange_buy": "ByBit",
      "exchange_sell": "Gate",
      "spread_pct": 0.11,
      "deposit_enabled_buy": true,
      "volume_24h_sell": null
    }
  ],
  "meta": {
    "count": 1,
    "updated_at": 1783802410,
    "freshness_sec": 10,
    "plan": "pro"
  }
}

Toute réponse réussie de Genesis API a la même forme : success est l’indicateur de succès, data contient les données et meta porte le nombre d’éléments, l’heure unix de construction des données, le délai de livraison de votre forfait en secondes et votre forfait. Un null dans volume_24h_sell signifie l’absence de données : ne le traitez pas comme zéro. Les détails sont dans la section Format de réponse.

Analyse en Python

import os
import requests

response = requests.get(
    "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
    headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
    params={"min_spread": 0.5},
    timeout=10,
)
body = response.json()  # JSON → dict
if not body["success"]:
    print(body["error"]["code"], body["error"]["message"])
else:
    for row in body["data"]:
        vol = row["volume_24h_sell"]  # null → None
        vol = "n/d" if vol is None else f"${vol:,.0f}"
        print(row["coin"], f"{row['spread_pct']}%", vol)

response.json() transforme le texte de la réponse en dictionnaire Python. Si le corps n’est pas du JSON, par exemple une page d’erreur de proxy, la méthode lève requests.exceptions.JSONDecodeError. Une analyse réussie ne signifie pas une requête réussie : les erreurs de Genesis API arrivent sous la même forme de JSON avec "success": false et un objet error, et les codes sont dans la section Erreurs.

Voir aussi : API REST, spread, format de réponse, ETag et erreurs, leçon : votre première requête API avec HTTP, en-têtes et JSON.

Questions et réponses

Comment convertir updated_at en date ?

C’est une heure unix en secondes. En Python, datetime.fromtimestamp(1783802410, timezone.utc) donne le 11 juillet 2026 à 20:40:10 UTC.