Genesis Arbitrage

Genesis Arbitrage · · 2 мин чтения

JSON

JSON (JavaScript Object Notation) — текстовый формат обмена данными, в котором значения собраны в объекты в фигурных скобках и массивы в квадратных. Формат описан в RFC 8259 и стандарте ECMA-404, тип содержимого — application/json. В JSON отвечает и Genesis API.

Типы значений

ТипПримерВ Python
Объект{"coin": "BTC"}dict
Массив[0.11, 0.45]list
Строка"ByBit"str
Число214, 0.92int, float
Логическоеtrue, falseTrue, False
Пустое значениеnullNone

Имена полей и строки пишут только в двойных кавычках. Комментариев в JSON нет, а запятая после последнего элемента делает документ неверным.

Ответ Genesis API

Условный пример ответа эндпоинта /arbitrage/spot-spot: одна строка, часть полей опущена.

{
  "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"
  }
}

Все успешные ответы Genesis API устроены одинаково: success — признак успеха, data — данные, meta — число элементов, unix-время сборки данных, задержка отдачи на вашем тарифе в секундах и тариф. null в volume_24h_sell значит «нет данных», считать его нулём нельзя. Подробно — в разделе «Формат ответа».

Разбор в 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 = "нет данных" if vol is None else f"${vol:,.0f}"
        print(row["coin"], f"{row['spread_pct']}%", vol)

response.json() превращает текст ответа в словарь Python. Если пришёл не JSON, например страница ошибки прокси, метод бросит requests.exceptions.JSONDecodeError. Успешный разбор ещё не значит успешный запрос: ошибки Genesis API приходят тем же JSON с "success": false и объектом error, коды — в разделе «Ошибки».

Смотрите также: REST API, спред, формат ответа, ETag и ошибки, урок «Первый запрос к API: HTTP, заголовки и JSON».

Вопросы и ответы

Как перевести updated_at в дату?

Это unix-время в секундах. В Python datetime.fromtimestamp(1783802410, timezone.utc) даёт 11 июля 2026 года, 20:40:10 UTC.