API криптовалют: какие бывают, чем отличаются и как выбрать для трейдинга
Коротко
- API криптовалют отдаёт программе данные рынка: цены, стаканы, ставки фандинга, транзакции, котировки рынков предсказаний. API биржи покрывает одну площадку и принимает ордера по ключу, API рыночных данных сводит многие площадки в один формат.
- API выбирают по девяти критериям: покрытие площадок и сетей, свежесть, нормализация полей, статусы ввода и вывода, глубина стаканов, лимиты, цена, документация и условия использования данных.
- Genesis API — REST API только для чтения: CEX, DEX, ончейн, рынки предсказаний и букмекерские вилки в одном формате JSON, тарифы от $20 в месяц. Ордера через него не ставятся.
API криптовалют — программный интерфейс, через который код получает данные крипторынка или отправляет ордера на биржу: цены, стаканы заявок, ставки фандинга, транзакции в блокчейне, котировки рынков предсказаний. Виды API различаются охватом: API биржи знает одну площадку и принимает ордера по ключу, API рыночных данных сводит многие площадки в один формат, ончейн-API читает блокчейн.
Какие бывают API криптовалют
| Вид API | Что даёт | Когда нужен |
|---|---|---|
| API биржи | Цены, стаканы, сделки одной биржи; ордера по ключу | Торговля на бирже, поток сделок пары |
| API рыночных данных | Многие биржи в одном формате, готовые спреды | Сравнение бирж, сканеры, алерты |
| Ончейн-API | Транзакции, переводы, балансы, события контрактов | Киты, потоки на биржи, разлоки |
| API DEX | Цены и ликвидность пулов, свапы, проскальзывание | Токены вне CEX, связки DEX – CEX |
| Данные деривативов | Фандинг, открытый интерес, цены фьючерсов | Арбитраж фандинга, перекос позиций |
| API рынков предсказаний и коэффициентов | Цены YES и NO, стаканы, коэффициенты букмекеров | Арбитраж прогнозов, вилки |
API бирж
API биржи криптовалют — интерфейс одной площадки из двух частей. Публичная часть отдаёт рыночные данные без ключа: у Binance такие эндпоинты имеют тип безопасности NONE, а курс пары возвращает GET /api/v3/ticker/price. Приватная часть — ордера, баланс, история сделок — требует API-ключ и подпись запроса, у Binance это типы TRADE и USER_DATA (документация Binance).
Охват такого API — одна биржа: чтобы сравнить цену монеты на 20 биржах, нужно 20 подключений с разными форматами и лимитами.
API рыночных данных
API рыночных данных собирает данные многих бирж, приводит их к одному формату и отдаёт одним запросом. В ответе уже посчитано то, что требует сведения площадок: спреды между биржами, ставки фандинга, приведённые к одному периоду, открытый интерес по биржам.
Ончейн-API
Ончейн-API читает блокчейн: транзакции, переводы токенов, балансы адресов, события смарт-контрактов. Нижний уровень — нода сети: каждый клиент Ethereum отвечает по JSON-RPC, где eth_getBalance возвращает баланс в wei шестнадцатеричным числом, а eth_getLogs — события контрактов по фильтру.
Метки адресов — биржа, команда, кит — нода не знает, их добавляют индексаторы и сервисы ончейн-аналитики. Какие данные нужны трейдеру — в статье «API ончейн-данных».
API DEX
API DEX отдаёт цены и ликвидность пулов децентрализованных бирж, свапы и проскальзывание. Чем крупнее обмен относительно ликвидности пула, тем сильнее он сдвигает цену, поэтому связке DEX – CEX нужно проскальзывание на вашу сумму, а новым токенам — налог токена и проверка на honeypot. Подробнее — «DEX API».
Данные деривативов: фандинг и открытый интерес
Для бессрочных фьючерсов нужны ставка фандинга, открытый интерес (объём незакрытых позиций) и цена фьючерса рядом со спотом. Биржи начисляют фандинг раз в 8, 4 или 1 час, и ставки сравнивают, приведя к одному периоду. Подробнее — в статьях «API ставок фандинга» и «API открытого интереса».
API рынков предсказаний и коэффициентов
Площадки прогнозов отдают цены контрактов YES и NO и стаканы. У Polymarket публичные рыночные данные доступны без ключа, а ордер требует авторизации и подписи кошелька (документация Polymarket).
Форматы и здесь разные: стакан Kalshi содержит только заявки на покупку, и цена покупки YES равна $1 минус лучший бид NO, при биде $0,56 это $0,44 (документация Kalshi). Коэффициенты букмекеров сравнивают с ценами YES и NO через вероятность — см. статьи «API Polymarket и Kalshi» и «API коэффициентов букмекеров».
REST и WebSocket
REST API отвечает на запрос снимком данных с нужными фильтрами, а обновления получают опросом по расписанию.
WebSocket держит соединение открытым, и сервер сам присылает каждую сделку и изменение стакана. Взамен поток обрабатывают без пропусков, переподключаются после обрыва и собирают стакан из снимка и изменений, а у Kalshi подключение требует авторизации даже для публичных каналов. Для реакции за доли секунды нужен WebSocket, для сканеров и алертов по 20+ биржам хватает REST.
У Genesis API только REST, без WebSocket и вебхуков: все запросы — GET, ответ — JSON со сжатием gzip, отдача обновляется раз в meta.freshness_sec секунд. Повторный запрос полного набора без фильтров с прошлым ETag в If-None-Match получает 304 без тела, если данные не изменились, и квоту не тратит. Схема опроса — в статье «Как опрашивать API без лимитов».
Как выбрать API криптовалют: чек-лист
Первые шесть критериев видны в живом ответе API, остальные — в документации и тарифах.
| Критерий | Что проверить |
|---|---|
| Покрытие площадок и сетей | Ваши биржи, спот и фьючерсы, DEX и сети |
| Свежесть и задержка | Время сборки в ответе, шаг обновления, возраст стаканов |
| Нормализация полей | Единые тикеры, единицы, проценты и время |
| Статусы ввода и вывода | Флаги депозита и вывода по бирже и сети |
| Глубина стаканов | Цена исполнения на вашу сумму |
| Лимиты и квоты | Запросы в секунду, вызовы за период, что считается вызовом |
| Цена | Тариф или оплата за вызов, что сверх лимита |
| Документация и OpenAPI | Примеры запросов и ответов, спецификация |
| Условия использования данных | Можно ли строить на данных свой продукт |
Покрытие и свежесть
Покрытие сверяют со своим списком: если бот работает с MEXC и Gate, API без одной из них не подходит. Свежесть данных — сколько секунд прошло со сборки снимка, задержка — весь путь от сделки на бирже до вашего кода. По снимку минутной давности бот видит спреды, которых на бирже уже нет.
Нормализация полей
Одна пара BTC/USDT в API бирж записывается по-разному: у Binance — BTCUSDT, у OKX — BTC-USDT (бессрочный фьючерс — BTC-USDT-SWAP), у Gate — BTC_USDT. Binance отдаёт цену строкой ("price": "4.00000200" в примере документации) и время в миллисекундах. Каждую такую разницу код разбирает сам.
API рыночных данных приводит поля к одному виду, как в строке /funding/rates из документации Genesis API:
{
"coin": "TON",
"exchanges": [
{
"exchange": "MEXC",
"funding_pct": 0.02,
"funding_8h_pct": 0.04,
"next_payout": "00:00",
"interval": "4h",
"price": 2.184,
"trade_url": "https://futures.mexc.com/exchange/TON_USDT"
}
]
}
MEXC начисляет фандинг этой монеты раз в 4 часа, и ставка 0,02 % за интервал в funding_8h_pct приведена к 8 часам: 0,02 × 8 / 4 = 0,04 % (раздел «Ставки фандинга»).
Статусы ввода и вывода
Межбиржевая связка на споте исполнима, только если монету можно вывести с биржи покупки и зачислить на бирже продажи. У Binance статусы сетей отдаёт GET /sapi/v1/capital/config/getall — подписанный эндпоинт USER_DATA, нужен ключ аккаунта на бирже (документация Binance). В Genesis API статусы приходят в каждой строке Спот – Спот: withdraw_enabled_buy и deposit_enabled_sell (раздел «Спот — Спот»).
Глубина стаканов
Спред по лучшим ценам показывает расхождение на первом уровне стакана, а сделка на $5 000 проходит несколько уровней глубины рынка. В примере из документации Genesis API для /orderbooks/spreads/spot-futures спред BTC по лучшим ценам — 0,031 %, после прохода по стаканам на $5 000 — 0,0202 %. Цены исполнения на $500–10 000 отдаёт эндпоинт «Цена исполнения», подробнее — в статье «API биржевого стакана».
Лимиты, цена и документация
Лимиты считают по-разному. У Binance у каждого эндпоинта свой «вес», запросы по многим символам весят больше, а за продолжение запросов после 429 биржа банит IP-адрес — от 2 минут до 3 дней (лимиты Binance). У API данных смотрите квоту вызовов, лимит запросов в секунду и что считается вызовом: в Genesis API квоту тратит только ответ 200.
Цена — тариф с квотой или оплата за вызов; узнайте, что будет сверх лимита: ошибка 429 или списание денег. Спецификация OpenAPI — машиночитаемое описание API для генерации клиента и подключения ИИ-агентов, а условия использования говорят, можно ли строить на данных продукт и что нельзя перепродавать.
Проверка одним запросом
Скрипт берёт полный набор Спот – Спот (есть на всех тарифах Genesis API) и по одному ответу проверяет покрытие, возраст снимка и долю переводимых связок:
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
r = requests.get(BASE + "/arbitrage/spot-spot",
headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]
# Покрытие: какие биржи встречаются в связках
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("бирж в ответе:", len(venues), sorted(venues))
# Свежесть: возраст снимка и шаг обновления тарифа
age = time.time() - meta["updated_at"]
print(f"снимку {age:.0f} с, шаг тарифа {meta['freshness_sec']} с")
# Перевод: вывод открыт на бирже покупки, ввод — на бирже продажи
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"переводимых связок: {len(ok)} из {len(rows)}")
Повторы при 429 и 503 добавляет функция get_json из инструкции «Ответы и ошибки Genesis API». Затем сверьте цены и статусы 3–5 связок с биржами по ссылкам trade_url_buy и trade_url_sell.
Сделать самому или взять готовое
Для одной-двух бирж и торговли свой код на их API — естественный выбор. Для 20 бирж со спотом и фьючерсами это до 40 коннекторов рыночных данных: у Binance спот и USDⓈ-M фьючерсы — разные API, api.binance.com и fapi.binance.com. У каждого коннектора — REST-снимки, поток WebSocket с переподключением, свои лимиты и формат символов, а сверху — сведение: монеты сопоставляют по контракту и сети, ведь один тикер на разных биржах бывает разными токенами.
| Задача | Свой код на API бирж | Genesis API |
|---|---|---|
| Ставить ордера | Только так: торговый API биржи | Нет, только чтение |
| Каждая сделка одной пары | WebSocket биржи | Нет, снимки раз в 60–5 с |
| Спреды по 20+ биржам | До 40 коннекторов и сведение | Один запрос |
| Статусы ввода и вывода | Эндпоинт каждой биржи, у Binance — с ключом | Поля в строке связки |
| DEX, ончейн, прогнозы | Ноды, индексаторы, API площадок | Тот же формат JSON |
Подходы совмещают: связки ищет API данных, а сделку открывают на бирже вручную или через её торговый API с ключом без права вывода (см. «Как защитить аккаунт на криптобирже»). Бот с уведомлениями в Telegram — в статье «Бот для арбитража криптовалют на Python».
Где здесь Genesis API
Genesis API — REST API с данными Genesis Arbitrage: CEX, DEX, ончейн, рынки предсказаний и букмекерские вилки в одном формате JSON, ключ — в заголовке X-API-Key. Он отдаёт то же, что публикует сайт, через 35+ эндпоинтов (37 операций в спецификации) и только читает данные.
| Данные | Пример эндпоинта | Тарифы API |
|---|---|---|
| Спреды CEX | /arbitrage/spot-spot | Все |
| DEX и Кроссчейн | /arbitrage/dex-spot | Pro, Max |
| Стаканы | /orderbooks/exec | Pro, Max |
| Фандинг и OI | /funding/rates | Все |
| Ончейн | /onchain/{section} | Start, Pro, Max |
| Прогнозы и вилки | /predictions/arbitrage | Start: exact, dutch; Pro, Max: llm, sport |
Покрытие: 20+ CEX-бирж (Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, Kraken, WhiteBit, Coinbase, CoinW, edgeX, HTX, Hyperliquid и другие), фандинг по 1000+ монет с приведением к 8 часам, открытый интерес по 13+ фьючерсным биржам. Рынки предсказаний — Polymarket, Kalshi, Limitless, Predict.fun и Opinion, режим sport — букмекерские вилки 13 площадок, только прематч.
| Тариф | Вызовов в месяц | Запросов в секунду | Свежесть |
|---|---|---|---|
| Trial, $20 в месяц | 500 тыс. | 1 | 60 с |
| Start, $50 | 2 млн | 2 | 30 с |
| Pro, $100 | 5 млн | 5 | 10 с |
| Max, $200 | 10 млн | 15 | 5 с |
Тарифы API отдельны от подписки на сайт, оплата — криптовалютой, за 3 месяца скидка 10 %, за 6 — 20 %. Сверх лимитов сервер отвечает 429 без списания денег, вне тарифа — 403 plan_restricted. Сравнение — на странице «Тарифы Genesis API», правила — в разделе «Тарифы и лимиты».
В документации у каждого раздела свой адрес: параметры, поля, пример curl и форма «Проверить запрос». Для программ и ИИ-агентов есть спецификация OpenAPI 3.1 и справочник llms-full.txt, подключение — в инструкции «Genesis API для ИИ-агентов». Строить на Genesis API свои сервисы, ботов и дашборды можно, перепродавать сырые данные как есть — нельзя.
Первый запрос — тариф, ключ в профиле и GET с X-API-Key — описан в быстром старте, основы — в уроке «Что такое API криптовалют и что можно автоматизировать». Без кода те же данные есть в таблицах сайта и в уведомлениях в Telegram.
Вопросы и ответы
Есть ли бесплатный API криптовалют?
Есть: публичные API бирж отдают цены, стаканы и сделки бесплатно и без ключа (у Binance — эндпоинты типа NONE), но каждый покрывает одну биржу. Бесплатного тарифа у Genesis API нет: Trial стоит $20 в месяц за 500 тыс. вызовов.
Нужен ли SDK, чтобы работать с API криптовалют?
Для REST API хватит HTTP-клиента: curl, requests в Python или fetch в JavaScript. У Genesis API официального SDK нет, все запросы — GET с одним заголовком; типизированного клиента можно сгенерировать из спецификации OpenAPI 3.1.
Можно ли торговать через API рыночных данных?
Нет, если API только читает данные, как Genesis API: он находит связки, но ордеров не ставит. Ордер ставят на бирже вручную или через её торговый API с ключом и подписью (у Binance — эндпоинты типа TRADE), это вне Genesis API и на ваш риск.
Как получить курс криптовалюты через API?
Курс пары на одной бирже отдаёт её публичный эндпоинт, у Binance — GET /api/v3/ticker/price (цена приходит строкой). Цены монеты на всех биржах со статусами ввода и вывода отдаёт /coins/search?query=BTC в Genesis API («Поиск монет»).