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
| Type | Exemple | En Python |
|---|---|---|
| Objet | {"coin": "BTC"} | dict |
| Tableau | [0.11, 0.45] | list |
| Chaîne | "ByBit" | str |
| Nombre | 214, 0.92 | int, float |
| Booléen | true, false | True, False |
| Valeur vide | null | None |
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.