Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

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

TipoExemploEm Python
Objeto{"coin": "BTC"}dict
Array[0.11, 0.45]list
String"ByBit"str
Número214, 0.92int, float
Booleanotrue, falseTrue, False
Valor vazionullNone

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.