Genesis Arbitrage

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

Бот для арбитража криптовалют на Python: от API спредов до уведомлений в Telegram

Коротко

  • Бот для арбитража криптовалют — четыре звена: данные о спредах, отбор исполнимых связок, уведомление и решение человека. Код делает первые три, сделку на биржах открываете вы.
  • Самое трудное в арбитраже — исполнение: перевод монеты, комиссии, проскальзывание и время. Поэтому бот оставляет связки с открытым выводом и вводом, а на тарифах Pro и Max ещё и пересчитывает спред по стаканам на $1 000.
  • Бот опрашивает Genesis API не чаще meta.freshness_sec, при 429 и 503 ждёт Retry-After и пишет об одной связке не чаще раза в 15 минут. Базовой версии хватает тарифа Trial за $20 в месяц.

Бот для арбитража криптовалют — программа, которая по расписанию получает спреды между биржами, то есть разницу цен одной монеты в процентах, оставляет связки, которые можно исполнить, и присылает о них уведомление. Решение принимает и сделку открывает человек. Код такого бота для межбиржевого арбитража на споте — около 140 строк на Python: спреды он берёт из Genesis API, сообщения отправляет через Telegram Bot API.

Из чего состоит бот для арбитража

Любой арбитражный бот собран из четырёх звеньев:

ЗвеноЧто делаетВ этом боте
ДанныеПолучает цены и спреды по биржамGET /arbitrage/spot-spot Genesis API
ОтборОставляет связки, которые можно исполнитьСтатусы ввода и вывода, «Δ по ордерам» на $1 000
УведомлениеСообщает о связкеМетод sendMessage Telegram Bot API
Решение и сделкаПроверяет связку и торгуетЧеловек на биржах

Свой сборщик данных — самое долгое звено: у каждой биржи свой API, свои названия тикеров и сетей, свои статусы ввода и вывода, и всё это сводят к одному формату. Genesis API отдаёт готовые связки по 20+ CEX-биржам, среди них Binance, OKX, Bybit, Bitget, MEXC и Gate, с ценами, спредом, сетью, контрактом, статусами ввода и вывода и объёмами. Поля всех эндпоинтов арбитража — в инструкции «Эндпоинты арбитража Genesis API», выбор источника данных — в статье «API криптовалют: какие бывают и как выбрать».

Почему сделки остаются за человеком

Найти спред — лёгкая часть арбитража. Трудная — исполнение: между строкой в ответе API и деньгами на счёте стоят четыре препятствия.

Условный пример: бот прислал связку со спредом 1,2 %, на $1 000 это $12. После прохода по стаканам на $1 000 остаётся 0,8 %, то есть $8. Комиссия тейкера 0,1 % на покупке и на продаже — около $2, вывод монеты — $3.

Код, который сам покупает и выводит монету, превращает каждую такую ошибку в сделку без проверки. Поэтому бот присылает сигнал: вывод, ввод и спред после стаканов он проверяет сам, а контракт, комиссии и путь перевода человек сверяет перед сделкой. Торговать через Genesis API и нельзя: он только читает данные и ордеров не ставит. Ручная проверка связки по шагам — в статье «Межбиржевой арбитраж криптовалют».

Что понадобится

python3 --version   # нужен Python 3.10 или новее
python3 -m pip install requests

export GENESIS_API_KEY="gns_live_XXXXXXXXXXXXXXXX"
export TG_BOT_TOKEN="123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"

# после /start в чате с ботом найдите в ответе "chat":{"id":...}
curl "https://api.telegram.org/bot$TG_BOT_TOKEN/getUpdates"

export TG_CHAT_ID="123456789"

Переменные из export живут до закрытия терминала. Токен по документации Telegram даёт полный контроль над ботом, ключ — доступ к вашему тарифу, поэтому оба хранят только в переменных окружения: в код и в репозиторий их не кладут.

Код бота по шагам

Семь блоков ниже — полный листинг файла bot.py: сохраните их в один файл в том же порядке. Пороги в настройках условные, подберите их под свои комиссии и суммы.

1. Настройки

import os
import time

import requests

API = "https://api.genesisarbitrage.com/v1"
TG = "https://api.telegram.org/bot" + os.environ["TG_BOT_TOKEN"]
CHAT_ID = os.environ["TG_CHAT_ID"]

MIN_SPREAD = 1.0      # спред строки от 1 %
MIN_VOLUME = 50_000   # объём за 24 ч на обеих биржах от $50 000
MIN_EXEC = 0.5        # спред после стаканов на $1 000 от 0,5 %
TOP = 5               # связок за один проход, не больше
REPEAT_SEC = 15 * 60  # одна связка — не чаще раза в 15 минут
RECHECK_SEC = 5 * 60  # связку, которую съел стакан, ждём 5 минут

api = requests.Session()
api.headers["X-API-Key"] = os.environ["GENESIS_API_KEY"]
cache = {}       # запрос -> (ETag, ответ)
wait_until = {}  # связка -> время, до которого она молчит

Ключ уходит в заголовке X-API-Key каждого запроса сессии api, в адрес запроса его не вставляют. MIN_VOLUME отсекает связки, где суточный объём хотя бы на одной бирже меньше $50 000. В cache хранятся ETag ответов, в wait_until — время, до которого бот молчит о связке.

2. Запрос к Genesis API: Retry-After и ETag

def get(path, params=None):
    """GET к Genesis API: повторы по Retry-After и ETag."""
    key = (path, tuple(sorted((params or {}).items())))
    for _ in range(4):  # запрос и до трёх повторов
        hdr = {"If-None-Match": cache[key][0]} if key in cache else {}
        r = api.get(API + path, params=params, headers=hdr,
                    timeout=15)
        if r.status_code == 304:  # снимок не изменился
            return cache[key][1]
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # так приходит исчерпанная квота
                raise SystemExit(f"Квота исчерпана: ждать {wait} с")
            time.sleep(wait)
            continue
        r.raise_for_status()  # 400, 401, 403: повтор не поможет
        body = r.json()
        if "ETag" in r.headers:  # ETag есть только у полного набора
            cache[key] = (r.headers["ETag"], body)
        return body
    raise RuntimeError("Genesis API занят, повторю в следующем проходе")

429 приходит при превышении лимита запросов в секунду или объёма скачивания, 503 — пока данные пересобираются. Оба несут Retry-After, и get ждёт столько секунд, сколько просит сервер. Исчерпанная квота тоже отвечает 429, но с Retry-After до сброса, иногда в днях, и бот останавливается. 400, 401 и 403 повтор не исправит, их поднимает raise_for_status. Все лимиты — в инструкции «Лимиты Genesis API».

3. Спреды и отбор связок

def candidates():
    """Связки Спот – Спот, монету в которых можно перевести."""
    body = get("/arbitrage/spot-spot",
               {"min_spread": MIN_SPREAD, "min_volume": MIN_VOLUME})
    # вывод открыт на бирже покупки, ввод — на бирже продажи
    rows = [x for x in body["data"]
            if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
    rows.sort(key=lambda x: x["spread_pct"], reverse=True)
    return rows, body["meta"]["freshness_sec"]

min_spread и min_volume отбирают строки на сервере. Флагов ввода и вывода в параметрах нет, их проверяет код: монету можно перевести, если вывод открыт на бирже покупки (withdraw_enabled_buy), а ввод — на бирже продажи (deposit_enabled_sell). Поля, которые использует бот, в строке из документации Спот — Спот:

{
  "coin": "FUEL",
  "exchange_buy": "ByBit",
  "exchange_sell": "Gate",
  "spread_pct": 0.11,
  "network": "ETH",
  "contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c",
  "withdraw_enabled_buy": true,
  "deposit_enabled_sell": true,
  "volume_24h_buy": 17652.64,
  "volume_24h_sell": 12512.51,
  "trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT",
  "trade_url_sell": "https://www.gate.io/trade/FUEL_USDT",
  …
}

Эта строка фильтры бота не пройдёт: спред 0,11 % и объёмы меньше $50 000. Сеть и контракт бот кладёт в сообщение, чтобы вы сверили их на страницах вывода и пополнения обеих бирж.

4. Проверка стакана на $1 000

def exec_spread(row):
    """Спред после стаканов на $1 000. Только Pro и Max."""
    body = get("/orderbooks/spreads/spot-spot",
               {"coin": row["coin"], "volume": 1000})
    for x in body["data"]:
        od = x["order_delta"]
        if (x["exchange_buy"] == row["exchange_buy"]
                and x["exchange_sell"] == row["exchange_sell"]
                and od["status"] == "ok"):
            return od["spread_pct"]
    return None  # no_book, exhausted или связка уже пропала

Эндпоинт возвращает строки монеты в наборе Спот – Спот с объектом order_delta — «Δ по ордерам», спредом после прохода по стаканам: покупка идёт по аскам биржи покупки, продажа — в биды биржи продажи. Функция берёт строку с теми же биржами и order_delta.spread_pct при status ok; no_book значит, что стакана нет, exhausted — что его не хватило на $1 000. Стаканы отстают от биржи на 5–20 секунд, поля описаны в документации «Δ по ордерам» и в инструкции «Эндпоинты стаканов».

Шаг есть только на Pro и Max, на Trial и Start эндпоинт отвечает 403 plan_restricted. Бот узнаёт тариф при старте и там проверку пропускает: в сообщении будет пометка «стакан не проверен», а глубину вы смотрите в терминале биржи сами.

5. Сообщение в Telegram

def message(row, ex):
    buy, sell = row["exchange_buy"], row["exchange_sell"]
    if ex is None:
        book = "стакан не проверен (Trial или Start)"
    else:
        book = f"после стаканов на $1 000: {ex:.2f} %"
    return "\n".join([
        f'{row["coin"]}: {buy} → {sell}',
        f'Спред {row["spread_pct"]} %, {book}',
        f'Сеть {row["network"]}, контракт {row["contract"] or "—"}',
        f'Купить: {row["trade_url_buy"]}',
        f'Продать: {row["trade_url_sell"]}',
    ])


def send(text):
    """sendMessage Telegram Bot API, при 429 ждём retry_after."""
    for _ in range(3):
        r = requests.post(TG + "/sendMessage", timeout=15, json={
            "chat_id": CHAT_ID, "text": text,
            "link_preview_options": {"is_disabled": True}})
        if r.status_code != 429:
            r.raise_for_status()  # 400 или 401: чат или токен неверны
            return
        wait = r.json().get("parameters", {}).get("retry_after", 5)
        time.sleep(wait)  # флуд-контроль Telegram
    raise RuntimeError("Telegram не принял сообщение")

Метод sendMessage принимает chat_id и text длиной от 1 до 4096 знаков, запрос идёт на адрес https://api.telegram.org/bot<токен>/sendMessage (документация Telegram Bot API). link_preview_options с is_disabled убирает превью ссылок. При флуде Telegram отвечает 429 и пишет в parameters.retry_after, сколько секунд ждать. В одном чате Telegram просит не отправлять больше одного сообщения в секунду (FAQ для разработчиков ботов).

Сообщение выглядит так, условный пример:

XYZ: MEXC → Gate
Спред 1.4 %, после стаканов на $1 000: 0.62 %
Сеть ETH, контракт 0x…
Купить: https://…
Продать: https://…

6. Дедупликация: одна связка раз в 15 минут

def scan(books):
    """Один проход: спреды, стаканы, сообщения."""
    rows, pause = candidates()
    done = 0
    for row in rows:
        key = (row["coin"], row["exchange_buy"], row["exchange_sell"])
        if time.time() < wait_until.get(key, 0):
            continue  # о связке уже писали или её съел стакан
        if done == TOP:
            break
        done += 1
        ex = exec_spread(row) if books else None
        ok = not books or (ex is not None and ex >= MIN_EXEC)
        if ok:
            send(message(row, ex))
        # о связке молчим 15 минут, а если стакан мал — 5 минут
        hold = REPEAT_SEC if ok else RECHECK_SEC
        wait_until[key] = time.time() + hold
        time.sleep(1)  # не чаще запроса и сообщения в секунду
    return pause

Связка — тройка «монета, биржа покупки, биржа продажи». После сообщения о ней бот молчит 15 минут, даже если спред держится. Если стакан съел спред, бот вернётся к связке через 5 минут, и проверки стакана не тратят вызов на каждом проходе. За проход берётся не больше пяти связок с наибольшим спредом, после каждой — пауза в секунду: так бот укладывается и в совет Telegram, и в лимит запросов в секунду любого тарифа. Словарь живёт в памяти, после перезапуска свежие связки могут прийти повторно.

7. Цикл с паузой не меньше freshness_sec

def main():
    usage = get("/account/usage")["data"]  # квоту не тратит
    books = usage["plan"] in ("pro", "max")
    pause = usage["freshness_sec"]
    print("Тариф", usage["plan"], "| опрос раз в", pause, "с",
          "| стаканы:", "да" if books else "нет")
    while True:
        try:
            pause = scan(books)
        except requests.HTTPError as e:
            if e.response.status_code < 500:
                raise  # ключ, тариф или токен: повтор не поможет
            print("Сбой сервера, повторю:", e)
        except (requests.RequestException, RuntimeError) as e:
            print("Нет ответа, повторю:", e)
        time.sleep(pause)  # не чаще meta.freshness_sec


if __name__ == "__main__":
    main()

При старте бот вызывает /account/usage: запрос квоту не тратит и возвращает тариф и freshness_sec. Это свежесть данных — шаг, с которым тариф получает новый снимок: 60 секунд на Trial, 30 на Start, 10 на Pro и 5 на Max. Дальше пауза берётся из meta.freshness_sec, ведь опрос чаще вернёт тот же снимок. Сбои сети и ошибки 5xx бот переживает до следующего прохода, а остальные 4xx — неверный ключ, истёкшая подписка, тариф без эндпоинта, неверный токен или chat_id — его останавливают. Коды ошибок собраны в инструкции «Ответы и ошибки Genesis API», монитор спредов без Telegram — в уроке «Монитор спредов и фандинга на Python».

Как запустить и проверить

python3 bot.py
# Тариф trial | опрос раз в 60 с | стаканы: нет
  1. Дождитесь первого прохода

    Сообщения приходят, когда на рынке есть связки выше порогов. Если за несколько минут их нет, временно снизьте MIN_SPREAD и MIN_VOLUME: так видно, что цепочка от API до Telegram работает.

  2. Сверьте связку с таблицей

    Откройте Спот – Спот на сайте: та же монета и пара бирж есть в таблице. Цифры могут немного расходиться, потому что API отдаёт снимок с задержкой тарифа.

  3. Проверьте дедупликацию

    Та же связка не должна прийти раньше чем через 15 минут.

  4. Посмотрите расход вызовов

    Поле calls_used в /account/usage или строка «Использовано вызовов» в профиле: на Trial без проверок стакана бот тратит около 1 440 вызовов в сутки.

  5. Оставьте бота работать

    Команда nohup python3 bot.py >> bot.log 2>&1 & запускает бота в фоне, переменные окружения задайте в той же сессии терминала.

Какой тариф Genesis API нужен боту

Проход — один вызов /arbitrage/spot-spot, на Pro и Max ещё до пяти вызовов /orderbooks/spreads/spot-spot; квоту тратят только ответы 200. Верхняя оценка за 30 дней: (1 + проверки за проход) × 86 400 / пауза × 30.

ТарифОпросСтакан на $1 000Вызовов за 30 дней
Trial, $20 в месяцРаз в 60 сНет43 200 из 500 000
Start, $50 в месяцРаз в 30 сНет86 400 из 2 млн
Pro, $100 в месяцРаз в 10 сДаДо 1 555 200 из 5 млн
Max, $200 в месяцРаз в 5 сДаДо 3 110 400 из 10 млн

На Trial это 86 400 / 60 × 30 = 43 200 вызовов, 8,64 % квоты. На Pro в худшем случае, когда каждый проход проверяет пять стаканов, выходит 6 × 86 400 / 10 × 30 = 1 555 200 вызовов, или 31,1 % квоты. Правила квоты — в разделе документации «Тарифы и лимиты».

Риски бота для арбитража

Без кода: уведомления Genesis Arbitrage в Telegram

Если писать и держать своего бота не хочется, те же связки присылает раздел Genesis Arbitrage «Уведомления в Telegram». Вы создаёте бота в @BotFather, вставляете токен на сайте и выбираете категории, среди них Спот – Спот, DEX – Фьючерсы, Кроссчейн и арбитраж фандинга. Фильтры задают минимальный спред, биржи и сети, статус ввода и вывода и «Спред по ордерам», а «Время до повтора (мин)» ограничивает повторы одной связки. Персональный бот работает на тарифе Pro подписки сайта, отдельно от тарифов Genesis API; настройка — в инструкции «Уведомления в Telegram».

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

Может ли бот торговать сам?

Через Genesis API — нет: API только отдаёт данные и ордеров не ставит. Торговлю подключают через API самих бирж с торговыми ключами, и это отдельный код и ваш риск: устаревший спред или закрытый вывод становятся сделкой без проверки.

Сколько стоит такой бот?

Код бесплатный, сообщения бота пользователям Telegram тоже бесплатны. Платите вы за данные: Genesis API — от $20 в месяц на Trial, проверка стакана — с тарифа Pro за $100. Ещё нужен компьютер или сервер, который работает круглосуточно.

Какой тариф Genesis API нужен?

Для базового бота хватит Trial: /arbitrage/spot-spot есть на всех тарифах, новый снимок приходит раз в 60 секунд. Start обновляет данные раз в 30 секунд. Проверка «Δ по ордерам» на $1 000 работает только на Pro и Max.

Почему бот прислал связку, а на бирже спреда уже нет?

Данные приходят с задержкой тарифа, а разницу выкупают и другие трейдеры. Кроме того, спред строки считается по последним сделкам, а купить можно только по аску и продать по биду. Перед сделкой смотрите цены и стакан в терминале биржи.

Можно ли выложить бота на GitHub?

Да: строить своих ботов на Genesis API условия разрешают, запрещено только перепродавать сырые данные как есть. Ключ и токен в репозиторий не кладите. Если ключ попал в открытый код, нажмите «Перевыпустить» в профиле, а токен бота заменит команда /token в @BotFather.