Genesis Arbitrage

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

Что такое 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, разница 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».

Что понадобится дальше в курсе

Уроки идут по порядку:

Попробуйте

  1. Отправьте запрос без ключа

    Выполните в терминале curl "https://api.genesisarbitrage.com/health". Ответ {"ok":true} значит, что запрос дошёл, а сервер ответил в JSON.

  2. Сопоставьте таблицу и поля

    Откройте таблицу «Спот – Спот» и раздел документации «Спот — Спот». Найдите поля бирж, цен, спреда и статусов перевода: exchange_buy, price_sell, spread_pct, withdraw_enabled_buy.

  3. Выпишите свои рутинные задачи

    Возьмите три действия, которые вы повторяете каждый день, и отметьте для каждого по таблице выше: сайт, Genesis API или API биржи.

  4. Найдите эндпоинт для одной задачи

    Для задачи из Genesis API найдите эндпоинт в документации и выпишите нужные параметры, например coin и min_spread. Этот запрос вы отправите в уроке 2.