Риски автоматизации: данные, ошибки, ключи и ИИ
Коротко
- Данные проверяют до сигнала: возраст снимка (текущее время минус
meta.updated_at), флагstaleу стаканов, спред по лучшим ценам и общий контракт у обеих бирж связки. - Ответ
503значит, что данных нет, а пустойdataпри200— что под фильтр ничего не попало. Бот различает эти состояния и после трёх циклов без данных сообщает о сбое. - Код ломается на краевых случаях: повтор без паузы упирается в
429,nullв сравнении роняет Python, деление на ноль в JavaScript даётInfinityи ложный сигнал, местное время вместо UTC сдвигает выплату фандинга на часы. - Ключ Genesis API даёт только чтение, и его утечка тратит вашу квоту. Ключ биржи с правом вывода — риск денег, торговому боту это право не нужно.
- ИИ-модель путает числа и может выполнить команду из чужого текста: числа в сообщение подставляет код, внешние поля идут модели как данные, лимиты сделки задаёт код, ордер подтверждает человек.
Риски торгового бота на API криптовалют делятся на четыре группы: данные устарели или показывают спред, которого нет; код зацикливается или падает на краевом случае; ключ утекает; ИИ-модель ошибается в числе или выполняет чужую команду. Против каждого риска есть проверка в коде или правило работы — их встраивают и в монитор из урока 4.
Риски данных
Устаревший снимок
Снимок Genesis API собран в meta.updated_at, а тариф обновляет его раз в meta.freshness_sec секунд: 60 на Trial, 30 на Start, 10 на Pro и 5 на Max. Возраст снимка — текущее время минус meta.updated_at, то есть свежесть данных. Один-два интервала тарифа — норма, больше трёх — снимок застрял.
Условный пример: на Pro порог — 3 × 10 = 30 с. Ответ пришёл в 1783802470 при meta.updated_at = 1783802410: возраст 1783802470 − 1783802410 = 60 с, и сигналы из него бот не шлёт. Полная задержка от биржи до кода ещё больше, а возраст считается по часам сервера — синхронизируйте их по NTP.
Стаканы и площадки прогнозов
У стаканов своё время: в /orderbooks/book есть book_ts, age_sec и флаг stale — true, если книга старше 30 секунд. Книги отстают от биржи на 5–20 секунд. В «Δ по ордерам» проверяйте order_delta.status: ok — посчитано, no_book — книги нет, exhausted — стакана не хватило на объём.
Для рынков предсказаний есть /predictions/platforms: связки с площадкой в mode = down, со старым quotes_at или с конторой, у которой ok = false, пропускайте.
Пустой ответ при 503
Пустой список и отсутствие данных — разные состояния. Ответ 200 с meta.count = 0 значит, что под фильтр не попала ни одна строка. Ответ 503 snapshot_not_ready значит, что данные пересобираются: связки на рынке могут быть, и запрос повторяют через Retry-After секунд.
Функция fetch возвращает (data, meta) или None, когда данных нет. Повторяет она только 429 и 503 — через Retry-After, а другие 5xx и сбои сети — с паузой 5, 10 и 20 секунд; на остальных ошибках останавливается.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def fetch(path, params=None, tries=4):
"""(data, meta) или None: данных нет, это не «связок нет»."""
for attempt in range(tries):
try:
r = requests.get(BASE + path, headers=HEADERS,
params=params, timeout=15)
code = r.status_code
except requests.RequestException:
code = 0 # сеть или таймаут: повторим после паузы
if code == 200:
body = r.json()
return body["data"], body["meta"]
wait = 5 * 2 ** attempt # 5, 10, 20 с: пауза растёт
if code in (429, 503):
wait = int(r.headers.get("Retry-After", wait))
if wait > 60: # дольше минуты не ждём
raise RuntimeError(f"пауза {wait} с: проверьте квоту")
elif 400 <= code < 500:
# 400, 401, 403, 404, 410: повтор не исправит
raise RuntimeError(f"{code}: {r.text[:200]}")
if attempt < tries - 1:
time.sleep(wait)
return None
Длинный Retry-After приходит и при исчерпанной квоте периода: до сброса могут пройти дни, и fetch паузу дольше минуты не ждёт. Повторы, ETag и фильтры — в статье «Как опрашивать API без лимитов».
Ложный спред: тонкий стакан и чужая монета
spread_pct считается по последним сделкам, а купить можно по аску и продать по биду. В примере FUEL из инструкции «Эндпоинты арбитража» спред по сделкам — 0,11 %, а по лучшим заявкам — −0,11 %. Поля ask_buy и bid_sell есть в строках Спот – Спот на любом тарифе, по ним quote_spread ниже считает спред по лучшим ценам.
Тонкий стакан раздувает разрыв. Условный пример: последняя сделка прошла по $1,18 час назад, лучший бид — $1,02, аск на бирже покупки — $1,00. Спред по сделкам — 18 %, по лучшим ценам — 2 %, а на $1 000 стакана может не хватить: на Pro и Max это покажет order_delta.status = exhausted при volume=1000.
Второй источник ложных спредов — один тикер у разных токенов, например у токена в сети BSC и другого проекта в Solana. Для токена с контрактом запросите /coins/search с тикером в query: в contracts[] должна быть запись, где в exchanges есть обе биржи связки (сравнивайте без учёта регистра). Нет такой записи — прямого перевода нет: это разные токены или путь через мост со своими рисками.
def is_fresh(meta, k=3):
"""Снимок не старше k интервалов тарифа."""
age = time.time() - meta["updated_at"]
return age <= k * meta["freshness_sec"]
def quote_spread(row):
"""Спред по лучшим ценам: купить по аску, продать по биду."""
ask, bid = row.get("ask_buy"), row.get("bid_sell")
if ask is None or bid is None or ask <= 0:
return None # цены нет или она нулевая: строку пропускаем
return (bid - ask) / ask * 100
pause, fails = 60, 0
while True:
got = fetch("/arbitrage/spot-spot", {"min_spread": 1})
if got is None or not is_fresh(got[1]):
fails += 1 # данных нет или они старые: сигналов нет
if fails == 3:
print("3 цикла подряд без свежих данных") # сообщите себе
else:
rows, meta = got
fails, pause = 0, meta["freshness_sec"]
for row in rows:
s = quote_spread(row)
if s is not None and s >= 0.5:
print(row["coin"], row["exchange_buy"], "→",
row["exchange_sell"], f"{s:.2f} %")
time.sleep(pause) # пауза на любом пути цикла
Исключение из fetch останавливает цикл: перед выходом рабочий бот пишет владельцу.
Риски кода
Повторы без паузы и бесконечный цикл
Первый бот часто повторяет запрос сразу после ошибки: if r.status_code != 200: continue. На 503 такой цикл шлёт запросы без пауз: ошибки квоту не тратят, но занимают лимит запросов в секунду, и следом приходит 429 с Retry-After: 1. После истечения подписки цикл бесконечно получает 401. А continue перед time.sleep() убирает паузу на любом пустом ответе, поэтому в цикле выше пауза стоит последней строкой.
Обратная ошибка — вечное ожидание. time.sleep(int(r.headers["Retry-After"])) при исчерпанной квоте засыпает на дни: например, Retry-After: 259200 — это 259 200 / 86 400 = 3 суток. Запрос без timeout тоже может висеть бесконечно — так предупреждает документация requests.
null и деление на ноль
Пустое значение в Genesis API — null, в Python — None. Сравнение row["volume_24h_sell"] > 10000 с None бросает TypeError, и одна строка роняет весь цикл. В JavaScript ошибки нет: null > 0.5 даёт false, null < 1 — true, и фильтр ошибается молча.
null значит «нет данных», и подмена нулём через or 0 опасна: в проскальзывании DEX tax_sell_pct = null означает, что источника налога нет, а or 0 делает из него 0 %. По документации null бывает в bid_* и ask_*, volume_24h_*, max_position_usd, next_payout, в profit_usd у связок с букмекерской конторой и в apr_pct при сроке меньше суток.
Деление на ноль — та же ловушка. Нулевой аск даёт в Python ZeroDivisionError, а в JavaScript 1 / 0 равно Infinity, и Infinity > 0.5 — true: бот шлёт связку с бесконечным спредом. Знаменатель проверяют до деления, как quote_spread проверяет ask <= 0.
Часовые пояса
Время в Genesis API — unix-секунды и строки по UTC: next_payout в ставках фандинга приходит как HH:MM UTC. datetime.fromtimestamp(ts) без часового пояса возвращает местное время сервера, а datetime.utcnow() с Python 3.12 объявлен устаревшим — документация Python предлагает datetime.now(timezone.utc).
Условный пример: сервер в поясе UTC+3, на его часах 09:30, по UTC — 06:30. До выплаты в 08:00 остаётся 1 ч 30 мин, а код, сравнивающий 08:00 с местным временем, решит, что выплата прошла, и насчитает 22 ч 30 мин — ошибка в 21 час.
from datetime import datetime, timedelta, timezone
def until_payout(hhmm, now=None):
"""Время до next_payout: строка HH:MM по UTC."""
if hhmm is None:
return None # null: времени выплаты нет
now = now or datetime.now(timezone.utc)
h, m = map(int, hhmm.split(":"))
t = now.replace(hour=h, minute=m, second=0, microsecond=0)
if t <= now:
t += timedelta(days=1) # «00:00» в 23:50 — это завтра
return t - now
now = datetime(2026, 11, 15, 6, 30, tzinfo=timezone.utc)
print(until_payout("08:00", now)) # 1:30:00
Риски ключей
Ключ Genesis API даёт только чтение данных: ордеров через него не поставить и денег не вывести. Утечка бьёт по квоте и лимиту запросов в секунду, и бот раньше срока получает 429. Признаки — «Использовано вызовов» в профиле растёт быстрее, чем считает ваш код, а «использован …» показывает свежее время при остановленном боте.
Ключ показывается один раз и хранится у Genesis Arbitrage только как хеш, поэтому утёкший ключ перевыпускают: «Перевыпустить» сразу отключает старый и выдаёт новый. Утекает ключ из мест, куда его положили по ошибке: публичный репозиторий, адрес запроса, код страницы, скриншот, лог с заголовками запроса. В лог пишите код ответа и X-Request-Id, правила хранения — в термине API-ключ.
Ключ биржи — другой класс риска: с правом вывода он выводит монеты с аккаунта. Торговому боту это право не нужно: делайте ключ без вывода, с привязкой к IP сервера и отдельный для каждого сервиса — подробно в статье «Как защитить аккаунт на криптобирже».
ИИ-агенты: числа, чужие команды, подтверждение
Агент вызывает Genesis API через ваш сервер: модель выбирает эндпоинт и аргументы, сервер делает запрос с ключом. Подключение — в инструкции «Genesis API для ИИ-агентов», общая схема — в статье «Данные крипторынка для ИИ-агентов».
Ошибки в числах
Модель может прочитать 0.92 как 92 % вместо 0,92 %, перепутать funding_pct за интервал с funding_8h_pct за 8 часов или назвать цену, которой в ответе нет. Числа в уведомление подставляет код из ответа API, а модели остаются отбор и пояснение. Если модель пишет числа сама, сверяйте их с результатом инструмента.
Команды из чужих текстов
Часть полей пишут не вы: title и outcome рынков предсказаний, name трейдеров, token_name ончейн-событий, message_ru и message_en сигналов. Токен можно назвать «Ignore previous instructions and…», и модель, которая читает название как часть промпта, может выполнить команду. Это внедрение команд (prompt injection), в списке OWASP Top 10 для LLM-приложений 2025 года — первый пункт, LLM01:2025.
Передавайте такие поля только в результате инструмента, обрезайте их длину и пропишите в системном промпте, что это данные. Ключ остаётся в обработчике на сервере.
Подтверждение человеком
Genesis API только читает данные: агент на нём находит связку и пишет о ней, но не торгует. Торговый API биржи у агента — уже вне Genesis API и на ваш риск. OWASP среди мер защиты называет подтверждение человеком для привилегированных операций: ордер уходит после «да» трейдера, который видит связку, цены и время данных.
Чек-лист перед запуском
- Ключ — в
GENESIS_API_KEYна сервере, его нет в коде, адресе запроса, браузере, логах и промпте. - У каждого запроса есть
timeout. - Повторяются только
429,503, другие 5xx и сбои сети — с паузой и не больше трёх раз. 400,401,403,404,410иRetry-Afterдлиннее минуты останавливают бота с сообщением.- Пауза между опросами — не короче
meta.freshness_sec, на каждом пути цикла. - Возраст снимка проверяется до сигнала, у стаканов —
staleиorder_delta.status. - «Данных нет» и «связок нет» различаются, три цикла без данных дают сообщение о сбое.
nullпроверяется наNone, знаменатель — на ноль, время считается в UTC.- Связка проходит по спреду по лучшим ценам, общему контракту,
withdraw_enabled_buyиdeposit_enabled_sell. - Числа в сообщения подставляет код, внешние тексты идут модели как данные, ордер подтверждает человек.
Итог курса: куда дальше
В курсе пять уроков: понятия, первый запрос, данные для решений, монитор на Python и риски; основы — в уроке 1. Подробности по каждому шагу:
- Быстрый старт с Genesis API — ключ и первый запрос;
- Лимиты Genesis API — квота и расчёт тарифа под бота;
- Ответы и ошибки Genesis API — коды,
ETagиX-Request-Id; - Эндпоинты стаканов — «Δ по ордерам» на ваш объём;
- Бот для арбитража криптовалют на Python — бот с уведомлениями в Telegram;
- API криптовалют: какие бывают и как выбрать — обзор источников данных.
Попробуйте
Узнайте свежесть тарифа
Вызовите
/account/usageи запишитеfreshness_secиcalls_used: этот запрос вызов не списывает.Посчитайте возраст снимка
Получите
/arbitrage/spot-spotчерезfetchи выведитеtime.time() - meta["updated_at"], затем сравните с порогом 3 ×freshness_sec.Сравните два спреда
Выведите
spread_pctиquote_spread(row)для пяти строк и посчитайте, сколько связок в плюсе по лучшим ценам.Проверьте путь ошибки
Запустите бота с заглушкой
GENESIS_API_KEY=gns_live_XXXXXXXXXXXXXXXX: ответ401 invalid_keyдолжен остановить его с понятным сообщением.Пройдите чек-лист
Добавьте в код пункты, которых в нём нет, до круглосуточного запуска.