Genesis Arbitrage

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

Риски автоматизации: данные, ошибки, ключи и ИИ

Коротко

  • Данные проверяют до сигнала: возраст снимка (текущее время минус 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 среди мер защиты называет подтверждение человеком для привилегированных операций: ордер уходит после «да» трейдера, который видит связку, цены и время данных.

Чек-лист перед запуском

  1. Ключ — в GENESIS_API_KEY на сервере, его нет в коде, адресе запроса, браузере, логах и промпте.
  2. У каждого запроса есть timeout.
  3. Повторяются только 429, 503, другие 5xx и сбои сети — с паузой и не больше трёх раз.
  4. 400, 401, 403, 404, 410 и Retry-After длиннее минуты останавливают бота с сообщением.
  5. Пауза между опросами — не короче meta.freshness_sec, на каждом пути цикла.
  6. Возраст снимка проверяется до сигнала, у стаканов — stale и order_delta.status.
  7. «Данных нет» и «связок нет» различаются, три цикла без данных дают сообщение о сбое.
  8. null проверяется на None, знаменатель — на ноль, время считается в UTC.
  9. Связка проходит по спреду по лучшим ценам, общему контракту, withdraw_enabled_buy и deposit_enabled_sell.
  10. Числа в сообщения подставляет код, внешние тексты идут модели как данные, ордер подтверждает человек.

Итог курса: куда дальше

В курсе пять уроков: понятия, первый запрос, данные для решений, монитор на Python и риски; основы — в уроке 1. Подробности по каждому шагу:

Попробуйте

  1. Узнайте свежесть тарифа

    Вызовите /account/usage и запишите freshness_sec и calls_used: этот запрос вызов не списывает.

  2. Посчитайте возраст снимка

    Получите /arbitrage/spot-spot через fetch и выведите time.time() - meta["updated_at"], затем сравните с порогом 3 × freshness_sec.

  3. Сравните два спреда

    Выведите spread_pct и quote_spread(row) для пяти строк и посчитайте, сколько связок в плюсе по лучшим ценам.

  4. Проверьте путь ошибки

    Запустите бота с заглушкой GENESIS_API_KEY=gns_live_XXXXXXXXXXXXXXXX: ответ 401 invalid_key должен остановить его с понятным сообщением.

  5. Пройдите чек-лист

    Добавьте в код пункты, которых в нём нет, до круглосуточного запуска.