Genesis Arbitrage

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

API

API (Application Programming Interface, программный интерфейс приложения) — набор правил, по которым одна программа запрашивает у другой данные или действие: какой адрес вызвать, что передать и в каком формате придёт ответ. Трейдеру API нужен, когда цены, стаканы и ставки фандинга должна читать программа: бот, таблица или дашборд.

Пример запроса

Условный пример: программа запрашивает у Genesis API профиль монеты IRYS через эндпоинт «Поиск монет». Запрос — HTTP GET, ключ — в заголовке:

curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
  -H "X-API-Key: $GENESIS_API_KEY"

Ответ приходит в формате JSON, часть полей опущена:

{
  "coin": "IRYS",
  "contracts": [
    {
      "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
      "network": "BNB Smart Chain(BEP20)",
      "exchanges": ["MEXC", "Ourbit"]
    }
  ],
  "exchanges": {
    "MEXC": {
      "spot_price": 0.01329,
      "futures_price": 0.0133,
      "deposit": true,
      "withdraw": true
    }
  }
}

Человек собирал бы это со страниц бирж и обозревателя блоков, программа получает одним ответом и сразу считает: фьючерс на MEXC дороже спота на (0,0133 − 0,01329) / 0,01329 × 100 ≈ 0,075 %.

Публичные и приватные API бирж

API биржи делится на две части. Публичная отдаёт рыночные данные — котировки, стаканы, сделки — без ключа. Приватная работает с аккаунтом: баланс, ордера, история сделок; ей нужен API-ключ и подпись запроса. На Binance публичные эндпоинты помечены типом NONE, остальные требуют ключ и параметр signature.

Данные идут двумя способами. REST API отвечает на каждый запрос отдельно: так получают снимок данных с нужными фильтрами. WebSocket держит соединение открытым, и сервер сам присылает обновления: у Binance так приходят сделки и изменения стакана в реальном времени.

API данных: много площадок в одном ответе

API одной биржи знает только свою площадку. Чтобы сравнить цену монеты на 20 биржах, программе нужно 20 подключений, а у каждой биржи свой формат ответа и свои лимиты. API данных сводит площадки заранее.

Вид APIЧто отдаётДоступ
Публичный API биржиКотировки, стаканы и сделки одной биржиБез ключа
Приватный API биржиБаланс, ордера, выводКлюч и подпись
Genesis APIСпреды, стаканы, фандинг, DEX, ончейн, рынки предсказанийКлюч, только чтение

Один запрос к Genesis API /arbitrage/spot-spot возвращает посчитанные спреды между спотовыми рынками 20+ CEX-бирж с флагами депозита и вывода. Все запросы — HTTP GET, ответы — JSON, параметры и поля каждого эндпоинта описаны в документации.

Смотрите также: API криптовалют: какие бывают и как выбрать, быстрый старт в документации, лимит запросов, урок «Что такое API криптовалют».

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

Нужен ли SDK, чтобы работать с API?

Если API отвечает по HTTP, хватит любого HTTP-клиента. Для Genesis API подойдут curl, requests в Python или встроенный fetch в JavaScript.

Можно ли торговать через Genesis API?

Нет. Genesis API только отдаёт данные. Ордера ставятся на бирже вручную или через API самой биржи по её ключу — на ваш риск.