Бот для арбитража криптовалют на 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 и деньгами на счёте стоят четыре препятствия.
- Перевод монеты: вывод и зачисление занимают от минут до часов, а биржа может закрыть ввод или вывод в любой момент.
- Комиссии: торговую берут обе биржи, а комиссия за вывод обычно фиксирована в монетах и на малой сумме съедает спред.
- Проскальзывание: спред считается по последним сделкам, а рыночный ордер проходит по стакану заявок, и покупка выходит дороже лучшего аска, продажа — дешевле лучшего бида.
- Время: данные приходят с задержкой тарифа, до 60 секунд на Trial, а ту же разницу видят и выкупают другие трейдеры.
Условный пример: бот прислал связку со спредом 1,2 %, на $1 000 это $12. После прохода по стаканам на $1 000 остаётся 0,8 %, то есть $8. Комиссия тейкера 0,1 % на покупке и на продаже — около $2, вывод монеты — $3.
Код, который сам покупает и выводит монету, превращает каждую такую ошибку в сделку без проверки. Поэтому бот присылает сигнал: вывод, ввод и спред после стаканов он проверяет сам, а контракт, комиссии и путь перевода человек сверяет перед сделкой. Торговать через Genesis API и нельзя: он только читает данные и ордеров не ставит. Ручная проверка связки по шагам — в статье «Межбиржевой арбитраж криптовалют».
Что понадобится
- Python 3.10 или новее и библиотека
requests. - Ключ Genesis API на любом тарифе: в профиле нажмите «Получить ключ» и сохраните
gns_live_…— ключ показывается один раз. Хранение и перевыпуск — в инструкции «API-ключ Genesis API». - Токен бота Telegram: отправьте @BotFather команду
/newbot, задайте имя и username, и BotFather пришлёт токен вида123456:ABC-DEF…. chat_id— номер вашего чата с ботом. Первым бот написать не может (документация Telegram): отправьте ему/startи вызовитеgetUpdates, число в"chat":{"id":…}и естьchat_id. Обновления хранятся не дольше 24 часов.
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 с | стаканы: нет
Дождитесь первого прохода
Сообщения приходят, когда на рынке есть связки выше порогов. Если за несколько минут их нет, временно снизьте
MIN_SPREADиMIN_VOLUME: так видно, что цепочка от API до Telegram работает.Сверьте связку с таблицей
Откройте Спот – Спот на сайте: та же монета и пара бирж есть в таблице. Цифры могут немного расходиться, потому что API отдаёт снимок с задержкой тарифа.
Проверьте дедупликацию
Та же связка не должна прийти раньше чем через 15 минут.
Посмотрите расход вызовов
Поле
calls_usedв/account/usageили строка «Использовано вызовов» в профиле: на Trial без проверок стакана бот тратит около 1 440 вызовов в сутки.Оставьте бота работать
Команда
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 % квоты. Правила квоты — в разделе документации «Тарифы и лимиты».
Риски бота для арбитража
- Устаревшая цена: снимок обновляется раз в
freshness_sec, стаканы отстают от биржи на 5–20 секунд, поэтому перед сделкой цены смотрят в терминале биржи. - Закрытые сети: флаги ввода и вывода верны на момент снимка, а вывод могут закрыть, пока вы покупаете. Под одним тикером бывают разные токены, поэтому сверяйте
contractиnetwork. - Комиссии и вывод:
spread_pctих не учитывает, а фиксированная комиссия вывода на малой сумме съедает весь спред. - Ложные спреды на тонких стаканах: большой спред по последней сделке на редко торгуемой монете пропадает на первом же ордере.
min_volumeи проверка на $1 000 отсекают часть таких связок, но не все. - Пробой лимита: лишние запросы в секунду получат
429сRetry-After: 1, исчерпанная квота остановит бота до сброса. Несколько ключей или аккаунтов ради обхода лимитов — нарушение правил, для большей нагрузки есть тарифы выше. Telegram при флуде тоже отвечает429.
Без кода: уведомления 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.