Быстрый старт с 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-клиентом.

Что есть в API
Эндпоинты повторяют разделы сайта:
- Арбитраж — Спот – Спот, Спот – Фьючерсы, Фьючерсы – Фьючерсы, DEX – Спот, DEX – Фьючерсы, Кроссчейн и Фондовый арбитраж.
- Стаканы — цена исполнения на объём по всем рынкам, «Δ по ордерам» для строк арбитража, стакан рынка, история исполнения и проскальзывание DEX (на тарифах API Pro и Max).
- Рынки предсказаний — арбитраж прогнозов и состояние площадок; аналитика, умные деньги, крупные сделки и рейтинг трейдеров — на тарифах API Pro и Max.
- Фандинг — ставки финансирования всех бирж, спред фандинга и историческая аналитика фандинга (на тарифах API Pro и Max).
- Рынок — Fair – Last, CEX Пампы – Дампы, DEX Дампы, Трекинг OI.
- Ончейн — крупные переводы, потоки на CEX, минт и бриджи, кошельки команд, позиции на Perp. DEX, разлоки, клеймы, взломы; на тарифах API Pro и Max — ещё обзор DEX, аналитика и страница монеты.
- AI и поиск — сигналы Genesis AI+ и полная карточка монеты.
- Аккаунт — состояние вашего ключа: тариф, использованная квота и лимиты.
Описание направлений — на странице «Genesis API», параметры и поля каждого эндпоинта — в документации.
Тарифы и лимиты
У API свои тарифы, отдельные от подписки на сайт: Trial, Start, Pro и Max. Они отличаются квотой вызовов, лимитом запросов в секунду и свежестью данных.
| Тариф API | Вызовов в месяц | Свежесть данных |
|---|---|---|
| Trial | 500 тыс. | 60 с |
| Start | 2 млн | 30 с |
| Pro | 5 млн | 10 с |
| Max | 10 млн | 5 с |
Trial стоит $20 в месяц, Max даёт 15 запросов в секунду. Эндпоинты, которые не входят в ваш тариф, отвечают ошибкой 403 с кодом plan_restricted. Запросы сверх лимитов не тарифицируются: дождитесь нового периода или повысьте тариф. Квоту расходуют только ответы 200: ошибки и ответы 304 бесплатны. Цены и сравнение тарифов — на странице «Тарифы Genesis API».
Первый запрос
Выберите тариф
На странице «Тарифы Genesis API» выберите тариф и срок и нажмите «Оформить подписку». Оплата — криптовалютой, как у подписки на сайт. Если у вас уже активен другой тариф API, при оплате нового он будет заменён, а остаток сгорит — сайт предупредит об этом.
Получите ключ
В профиле, в блоке Genesis API, нажмите «Получить ключ». Ключ вида
gns_live_…появится в окне «Ваш API-ключ» — нажмите «Копировать» и сохраните его. Он показывается один раз.Сделайте запрос
Отправьте обычный HTTP GET и передайте ключ в заголовке
X-API-Key. Базовый адрес API —https://api.genesisarbitrage.com/v1. Удобно начать с эндпоинта/account/usage— он показывает тариф и остаток квоты.Разберите ответ
Успешный ответ обёрнут в единый конверт: массив
dataи блокmeta. Если что-то пошло не так, сверьтесь с таблицей ошибок ниже.
Пример запроса на curl:
curl "https://api.genesisarbitrage.com/v1/account/usage" \
-H "X-API-Key: gns_live_…"
В документации есть форма «Проверить запрос»: вставьте ключ, нажмите «Отправить запрос» и получите сокращённый ответ прямо на странице. Ключ при этом хранится только в вашем браузере.
Формат ответа
- В
data— массив или объект, в зависимости от эндпоинта. Вmeta— число элементов, время последнего обновления данных, задержка для вашего тарифа в секундах и ваш тариф. - Пустые значения —
null. Время — unix-секунды. - Спреды и ставки — в процентах: число 0.92 означает 0,92%.
- Все параметры фильтров необязательны: без них эндпоинт вернёт полный набор данных.
Ошибки и лимиты
| Код | Что значит |
|---|---|
| 401 | Ключ отсутствует, неверен или отозван |
| 403 | Эндпоинт не входит в ваш тариф |
| 404 | Эндпоинт или ресурс не найден |
| 429 | Превышен лимит запросов — смотрите заголовки X-RateLimit и Retry-After |
| 500 | Внутренняя ошибка, повторите запрос позже |
| 503 | Данные пересобираются, повторите через несколько секунд — смотрите Retry-After |
Заголовки X-RateLimit в каждом ответе показывают лимит запросов в секунду, сколько запросов осталось в текущем окне и когда окно сбросится. Заголовки X-Quota показывают квоту вызовов на период, её остаток и время сброса. Каждый ответ также содержит X-Request-Id: при обращении в поддержку укажите его вместе со временем запроса в UTC, эндпоинтом и статусом. Сам ключ присылать не нужно.
Что дальше
- API-ключ: получить, хранить, перевыпустить — где ключ в профиле и как его защитить.
- Лимиты: квота, запросы в секунду, свежесть — как не упереться в ответ 429.
- Ответы и ошибки: JSON, ETag и коды HTTP — конверт ответа, 304 и повторы.
- Эндпоинты по группам: арбитраж, стаканы, фандинг, рынок и AI-сигналы, ончейн, рынки предсказаний и вилки.
- Genesis API для ИИ-агентов — спецификация OpenAPI, llms.txt и вызов функций.
Вопросы и ответы
Чем Genesis API отличается от бесплатных API бирж?
API бирж отдают стаканы и тикеры одной площадки. Genesis API отдаёт посчитанные спреды между десятками бирж и сетей, флаги депозита и вывода и данные, очищенные от неликвида.
Что будет, если превысить лимит?
Сервер ответит кодом 429 с заголовками X-RateLimit и Retry-After. Деньги за лишние запросы не списываются.
Можно ли сменить тариф API?
Да. Новый тариф начинает действовать сразу после оплаты: лимиты и свежесть применяются сразу, квота вызовов считается с нуля, а остаток прежнего тарифа сгорает. Продление того же тарифа добавляет дни к текущему сроку.
Можно ли использовать данные в своём продукте?
Да, на Genesis API можно строить собственные сервисы, ботов и дашборды. Нельзя перепродавать сырые данные как есть.