Что такое API криптовалют и что можно автоматизировать
Коротко
- API криптовалют — программный интерфейс, через который программа запрашивает данные рынка и получает ответ в JSON: тот же спред, что в таблице сайта, но полями
exchange_buy,exchange_sellиspread_pct. - API биржи даёт данные и счёт одной площадки, API рыночных данных сводит многие биржи в один формат, ончейн-API читает блокчейн. Genesis API — API рыночных данных только для чтения.
- Через API трейдер автоматизирует мониторинг спредов, фандинга и открытого интереса, уведомления, журнал сигналов, дашборды и исследование истории.
- Исполнение сделок и вывод средств без опыта лучше не автоматизировать: снимок данных отстаёт от биржи, а ошибка в коде повторяется на каждом цикле.
API криптовалют — программный интерфейс, через который ваша программа запрашивает данные крипторынка и получает ответ в виде, удобном для кода: цены, спреды между биржами, ставки фандинга, открытый интерес. Человек видит эти числа в таблице, программа получает их полями в JSON и сразу сравнивает с порогом, записывает или отправляет уведомление. Общее определение — в термине API.
Запрос и ответ
Работа с API — обмен двумя сообщениями: программа отправляет запрос на адрес, сервер возвращает ответ. Самый короткий пример — проверка состояния Genesis API, ключ для неё не нужен:
curl "https://api.genesisarbitrage.com/health"
{"ok":true}
curl — консольная программа для HTTP-запросов; установлена ли она, покажет команда curl --version. Запрос данных требует API-ключа — строки, по которой сервер узнаёт аккаунт и тариф. Условный пример: связки Спот – Спот по монете FUEL, ключ подставляется из переменной окружения GENESIS_API_KEY:
URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
"success": true,
"data": [
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"spread_pct": 0.11,
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
…
}
],
"meta": {
"count": 1,
"updated_at": 1794675861,
"freshness_sec": 60,
"plan": "trial"
}
}
В ответе одна связка: купить FUEL на ByBit по 0,0007029, продать на Gate по 0,0007037. Спред уже посчитан в spread_pct: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11 %. Флаги withdraw_enabled_buy и deposit_enabled_sell показывают, что вывод с ByBit и ввод на Gate открыты, а meta.updated_at — когда собран снимок. Те же числа показывает таблица «Спот – Спот», все поля описаны в разделе документации «Спот — Спот».
Адрес запроса складывается из базового адреса, пути эндпоинта и параметров, а ключ идёт отдельно — в заголовке X-API-Key. Каждую часть запроса, коды ответа и чтение JSON разбирает урок 2, там же показано, как задать переменную с ключом.
Такой обмен — запрос и ответ со снимком данных — называют REST API. Новые данные в нём получают повторным запросом: Genesis API обновляет отдачу раз в meta.freshness_sec секунд, от 60 на Trial до 5 на Max. Биржи дают и второй способ — WebSocket: соединение остаётся открытым, и сервер сам присылает сделки и изменения стакана, как в потоках Binance. У Genesis API WebSocket нет.
Какие бывают API криптовалют
API в крипте различаются тем, откуда берутся данные и что через них можно сделать:
- API биржи — данные и счёт одной площадки. Цены, стаканы и сделки биржа отдаёт публично, а баланс, ордера и историю сделок — только по ключу и подписи запроса. У Binance это записано типами безопасности:
NONE— открытые рыночные данные,TRADE— постановка и отмена ордеров,USER_DATA— данные аккаунта (документация Binance). - API рыночных данных — многие биржи и сети в одном формате. Он отдаёт то, что требует сведения площадок: спреды между биржами, ставки фандинга, приведённые к одному периоду, открытый интерес по биржам. Genesis API — такой API, и он только читает данные.
- Ончейн-API — данные блокчейна: транзакции, переводы токенов, балансы адресов. Метки «биржа», «команда проекта», «кит» добавляют сервисы аналитики поверх данных сети.
Сравнение шести видов API, разница REST и WebSocket и чек-лист выбора из девяти пунктов — в статье «API криптовалют: какие бывают и как выбрать».
Что трейдер может автоматизировать
Автоматизировать стоит то, что вы повторяете по одному правилу: открыть таблицу, сравнить число с порогом, записать результат. Программа делает это по расписанию и не пропускает ночные часы.
| Задача | Что делает программа | Данные Genesis API |
|---|---|---|
| Мониторинг спредов | Связки выше порога с открытыми вводом и выводом | /arbitrage/spot-spot, /arbitrage/spot-futures |
| Фандинг | Сравнивает ставки бирж, приведённые к 8 часам | /funding/rates, /funding/spread |
| Открытый интерес | Замечает резкие изменения OI за 5 минут – 1 час | /market/open-interest |
| Уведомления | Пишет в Telegram, когда условие выполнено | Любой эндпоинт с данными |
| Журнал | Сохраняет каждую найденную связку со временем | Ответ и meta.updated_at |
| Дашборд | Показывает ваши колонки и пороги на своей странице | Запросы с вашего сервера |
| Исследование истории | Ищет закономерности в прошлых данных | /funding/analytics/daily (Pro, Max) |
Уведомления — частый первый проект: программа опрашивает эндпоинт не чаще meta.freshness_sec и пишет вам, когда спред или ставка перешли порог. Без кода похожие сигналы присылают уведомления в Telegram на тарифе сайта Pro.
Журнал проверяет идею до денег. Условный пример: бот раз в 30 секунд записывает связки со спредом от 1 %, за сутки это 86 400 / 30 = 2 880 снимков. По ним видно, сколько связок продержалось дольше минуты, а сколько исчезло к следующему опросу.
Для истории в Genesis API есть аналитика фандинга — до года дневных сумм начисленного фандинга по 13 биржам — и история проскальзывания по стаканам, обе на тарифах Pro и Max. Исторических свечей в Genesis API нет: их отдают API бирж, у Binance это GET /api/v3/klines, до 1 000 свечей за запрос (документация Binance). Историю спредов между биржами программа собирает сама — из снимков журнала.
Что лучше не автоматизировать без опыта
Две операции дорого стоят при ошибке: исполнение сделок и вывод средств.
Исполнение сделок
Бот, который сам ставит ордера через торговый API биржи, ошибается с той же частотой, с какой работает: ошибка в условии входа при опросе раз в 10 секунд даст 3 600 / 10 = 360 ордеров за час. Данные тоже отстают: снимок Genesis API обновляется раз в 60–5 секунд в зависимости от тарифа, книги стаканов отстают от биржи на 5–20 секунд, и за это время спред может закрыться. Genesis API ордеров не ставит: он находит связки, а сделку вы открываете на бирже сами.
Вывод средств
Ключ биржи с правом вывода позволяет вывести деньги с аккаунта любому, кто его получил, и утечка такого ключа может стоить всего баланса. Ботам, которые читают данные или торгуют, это право не нужно. У Binance новый ключ по умолчанию не может даже торговать: право торговли включают отдельно.
Сайт, API бирж или Genesis API
| Задача | Удобнее | Почему |
|---|---|---|
| Смотреть связки и графики | Сайт Genesis Arbitrage | Таблицы и фильтры без кода |
| Сигналы без программирования | Уведомления в Telegram на сайте | Пороги задаются в интерфейсе |
| Свои условия по 20+ биржам | Genesis API | Спреды посчитаны, формат один |
| Ордера, баланс, вывод | API биржи | Ордер принимает только биржа |
| Каждая сделка в реальном времени | WebSocket биржи | Genesis API отдаёт снимки раз в 60–5 с |
| Свечи за прошлые периоды | API биржи | В Genesis API свечей нет |
| История фандинга по 13 биржам | Genesis API, Pro и Max | До года дневных сумм в одном формате |
Рабочая схема для старта: Genesis API находит связку, ваш бот присылает уведомление, а сделку вы проверяете в стакане биржи и открываете сами. Тарифы Genesis API — от Trial за $20 в месяц (500 тыс. вызовов, свежесть 60 с) до Max за $200 (10 млн вызовов, 5 с), бесплатного тарифа нет. Сравнение — на странице «Тарифы Genesis API».
Что понадобится дальше в курсе
- Ключ Genesis API: тариф на странице тарифов, ключ — кнопкой «Получить ключ» в профиле, путь по шагам — в быстром старте с Genesis API. Ключ держат в переменной окружения
GENESIS_API_KEYи не вставляют в адрес запроса. - curl — для первых запросов из терминала.
- Python 3.10+ и библиотека
requests(pip install requests) — для скриптов уроков 2 и 4. - Документация Genesis API: у каждого эндпоинта параметры, поля, пример на curl и форма «Проверить запрос», которая отправляет запрос прямо со страницы.
Уроки идут по порядку:
- урок 2 — первый запрос: адрес, заголовки, коды ответа и JSON;
- урок 3 — какие данные нужны для каких решений: спреды, стаканы, фандинг, ончейн;
- урок 4 — монитор спредов и фандинга на Python;
- урок 5 — риски автоматизации: устаревшие данные, ошибки, ключи и ИИ-агенты.
Попробуйте
Отправьте запрос без ключа
Выполните в терминале
curl "https://api.genesisarbitrage.com/health". Ответ{"ok":true}значит, что запрос дошёл, а сервер ответил в JSON.Сопоставьте таблицу и поля
Откройте таблицу «Спот – Спот» и раздел документации «Спот — Спот». Найдите поля бирж, цен, спреда и статусов перевода:
exchange_buy,price_sell,spread_pct,withdraw_enabled_buy.Выпишите свои рутинные задачи
Возьмите три действия, которые вы повторяете каждый день, и отметьте для каждого по таблице выше: сайт, Genesis API или API биржи.
Найдите эндпоинт для одной задачи
Для задачи из Genesis API найдите эндпоинт в документации и выпишите нужные параметры, например
coinиmin_spread. Этот запрос вы отправите в уроке 2.