JSON
JSON (JavaScript Object Notation) es un formato de texto para intercambiar datos en el que los valores se agrupan en objetos entre llaves y en arrays entre corchetes. Está especificado en RFC 8259 y en el estándar ECMA-404, y su tipo de medio es application/json. Genesis API también responde en JSON.
Tipos de valor
| Tipo | Ejemplo | En Python |
|---|---|---|
| Objeto | {"coin": "BTC"} | dict |
| Array | [0.11, 0.45] | list |
| Cadena | "ByBit" | str |
| Número | 214, 0.92 | int, float |
| Booleano | true, false | True, False |
| Valor vacío | null | None |
Los nombres de campo y las cadenas solo admiten comillas dobles. JSON no tiene comentarios, y una coma tras el último elemento invalida el documento.
Una respuesta de Genesis API
Ejemplo hipotético de una respuesta del endpoint /arbitrage/spot-spot: una fila, con algunos campos omitidos.
{
"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"
}
}
Toda respuesta correcta de Genesis API tiene la misma forma: success es el indicador de éxito, data contiene los datos y meta lleva el número de elementos, la hora unix en que se generaron los datos, el retraso de entrega de tu plan en segundos y tu plan. Un null en volume_24h_sell significa que no hay datos, así que no lo trates como cero. Los detalles están en la sección Formato de respuesta.
Análisis 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() convierte el texto de la respuesta en un diccionario de Python. Si el cuerpo no es JSON, por ejemplo una página de error de un proxy, el método lanza requests.exceptions.JSONDecodeError. Que el análisis funcione no significa que la petición haya funcionado: los errores de Genesis API llegan como el mismo tipo de JSON con "success": false y un objeto error, y los códigos están en la sección Errores.
Véase también: REST API, spread, formato de respuesta, ETag y errores, lección: tu primera petición a una API con HTTP, cabeceras y JSON.
Preguntas y respuestas
¿Cómo convierto updated_at en una fecha?
Es hora unix en segundos. En Python, datetime.fromtimestamp(1783802410, timezone.utc) da el 11 de julio de 2026, 20:40:10 UTC.