Genesis Arbitrage

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

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-spotPro, Max
Стаканы/orderbooks/execPro, Max
Фандинг и OI/funding/ratesВсе
Ончейн/onchain/{section}Start, Pro, Max
Прогнозы и вилки/predictions/arbitrageStart: 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 тыс.160 с
Start, $502 млн230 с
Pro, $1005 млн510 с
Max, $20010 млн155 с

Тарифы 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 («Поиск монет»).