JSON
JSON (JavaScript Object Notation) é um formato de texto para troca de dados em que os valores são agrupados em objetos entre chaves e em arrays entre colchetes. Ele é especificado na RFC 8259 e no padrão ECMA-404, e seu tipo de mídia é application/json. A Genesis API também responde em JSON.
Tipos de valor
| Tipo | Exemplo | Em Python |
|---|---|---|
| Objeto | {"coin": "BTC"} | dict |
| Array | [0.11, 0.45] | list |
| String | "ByBit" | str |
| Número | 214, 0.92 | int, float |
| Booleano | true, false | True, False |
| Valor vazio | null | None |
Nomes de campo e strings aceitam apenas aspas duplas. O JSON não tem comentários, e uma vírgula depois do último elemento invalida o documento.
Uma resposta da Genesis API
Exemplo hipotético de uma resposta do endpoint /arbitrage/spot-spot: uma linha, com alguns 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 resposta bem-sucedida da Genesis API tem o mesmo formato: success é o indicador de sucesso, data traz os dados e meta leva a quantidade de itens, o horário unix em que os dados foram gerados, o atraso de entrega do seu plano em segundos e o seu plano. Um null em volume_24h_sell significa que não há dados, então não o trate como zero. Os detalhes estão na seção Formato de resposta.
Parsing em 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() transforma o texto da resposta em um dicionário Python. Se o corpo não for JSON, por exemplo uma página de erro de proxy, o método lança requests.exceptions.JSONDecodeError. Um parsing bem-sucedido não significa uma requisição bem-sucedida: os erros da Genesis API chegam no mesmo tipo de JSON, com "success": false e um objeto error, e os códigos estão na seção Erros.
Veja também: REST API, spread, formato de resposta, ETag e erros, lição: sua primeira requisição a uma API com HTTP, cabeçalhos e JSON.
Perguntas e respostas
Como converto updated_at em uma data?
É um horário unix em segundos. Em Python, datetime.fromtimestamp(1783802410, timezone.utc) dá 11 de julho de 2026, 20:40:10 UTC.