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 самой биржи по её ключу — на ваш риск.