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.92 | int, float |
| Логическое | true, false | True, False |
| Пустое значение | null | None |
Имена полей и строки пишут только в двойных кавычках. Комментариев в 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.