Genesis Arbitrage

Genesis Arbitrage · · Обновлено · 5 мин чтения

Быстрый старт с Genesis API: ключ, первый запрос и лимиты

Коротко

  • Genesis API — REST-доступ к данным Genesis Arbitrage: спреды CEX и DEX, стаканы, фандинг, кроссчейн, ончейн-потоки, рынки предсказаний и сигналы Genesis AI+.
  • Путь до первого запроса — три шага: тариф, ключ в профиле, GET-запрос с заголовком X-API-Key.
  • Тариф определяет квоту вызовов, запросы в секунду и задержку данных — от 60 секунд на Trial до 5 секунд на Max.

Genesis API отдаёт данные Genesis Arbitrage в виде REST API: спреды между CEX и DEX, стаканы, фандинг, кроссчейн, ончейн-потоки, рынки предсказаний и сигналы Genesis AI+. Каждый инструмент сайта доступен как отдельный эндпоинт с единым форматом JSON. Чтобы сделать первый запрос, нужны тариф API, ключ и один HTTP-заголовок — SDK не требуется, подойдёт любой язык с HTTP-клиентом.

Быстрый старт с Genesis API: ключ, первый запрос и лимиты
Так это выглядит в Genesis Arbitrage

Что есть в API

Эндпоинты повторяют разделы сайта:

Описание направлений — на странице «Genesis API», параметры и поля каждого эндпоинта — в документации.

Тарифы и лимиты

У API свои тарифы, отдельные от подписки на сайт: Trial, Start, Pro и Max. Они отличаются квотой вызовов, лимитом запросов в секунду и свежестью данных.

Тариф APIВызовов в месяцСвежесть данных
Trial500 тыс.60 с
Start2 млн30 с
Pro5 млн10 с
Max10 млн5 с

Trial стоит $20 в месяц, Max даёт 15 запросов в секунду. Эндпоинты, которые не входят в ваш тариф, отвечают ошибкой 403 с кодом plan_restricted. Запросы сверх лимитов не тарифицируются: дождитесь нового периода или повысьте тариф. Квоту расходуют только ответы 200: ошибки и ответы 304 бесплатны. Цены и сравнение тарифов — на странице «Тарифы Genesis API».

Первый запрос

  1. Выберите тариф

    На странице «Тарифы Genesis API» выберите тариф и срок и нажмите «Оформить подписку». Оплата — криптовалютой, как у подписки на сайт. Если у вас уже активен другой тариф API, при оплате нового он будет заменён, а остаток сгорит — сайт предупредит об этом.

  2. Получите ключ

    В профиле, в блоке Genesis API, нажмите «Получить ключ». Ключ вида gns_live_… появится в окне «Ваш API-ключ» — нажмите «Копировать» и сохраните его. Он показывается один раз.

  3. Сделайте запрос

    Отправьте обычный HTTP GET и передайте ключ в заголовке X-API-Key. Базовый адрес API — https://api.genesisarbitrage.com/v1. Удобно начать с эндпоинта /account/usage — он показывает тариф и остаток квоты.

  4. Разберите ответ

    Успешный ответ обёрнут в единый конверт: массив data и блок meta. Если что-то пошло не так, сверьтесь с таблицей ошибок ниже.

Пример запроса на curl:

curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: gns_live_…"

В документации есть форма «Проверить запрос»: вставьте ключ, нажмите «Отправить запрос» и получите сокращённый ответ прямо на странице. Ключ при этом хранится только в вашем браузере.

Формат ответа

Ошибки и лимиты

КодЧто значит
401Ключ отсутствует, неверен или отозван
403Эндпоинт не входит в ваш тариф
404Эндпоинт или ресурс не найден
429Превышен лимит запросов — смотрите заголовки X-RateLimit и Retry-After
500Внутренняя ошибка, повторите запрос позже
503Данные пересобираются, повторите через несколько секунд — смотрите Retry-After

Заголовки X-RateLimit в каждом ответе показывают лимит запросов в секунду, сколько запросов осталось в текущем окне и когда окно сбросится. Заголовки X-Quota показывают квоту вызовов на период, её остаток и время сброса. Каждый ответ также содержит X-Request-Id: при обращении в поддержку укажите его вместе со временем запроса в UTC, эндпоинтом и статусом. Сам ключ присылать не нужно.

Что дальше

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

Чем Genesis API отличается от бесплатных API бирж?

API бирж отдают стаканы и тикеры одной площадки. Genesis API отдаёт посчитанные спреды между десятками бирж и сетей, флаги депозита и вывода и данные, очищенные от неликвида.

Что будет, если превысить лимит?

Сервер ответит кодом 429 с заголовками X-RateLimit и Retry-After. Деньги за лишние запросы не списываются.

Можно ли сменить тариф API?

Да. Новый тариф начинает действовать сразу после оплаты: лимиты и свежесть применяются сразу, квота вызовов считается с нуля, а остаток прежнего тарифа сгорает. Продление того же тарифа добавляет дни к текущему сроку.

Можно ли использовать данные в своём продукте?

Да, на Genesis API можно строить собственные сервисы, ботов и дашборды. Нельзя перепродавать сырые данные как есть.