Genesis Arbitrage

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

API-ключ Genesis API: как получить, где хранить, как перевыпустить и отозвать

Коротко

  • Ключ gns_live_… создаётся в профиле кнопкой «Получить ключ» и показывается один раз. У нас хранится только его хеш, поэтому потерянный ключ не восстановить — только перевыпустить.
  • Ключ передают в заголовке X-API-Key со своего сервера. В коде его читают из переменной окружения GENESIS_API_KEY, в адрес запроса и в код сайта не вставляют.
  • При утечке нажмите «Перевыпустить»: старый ключ сразу перестаёт работать, новый замените во всех программах. На аккаунт выдаётся один ключ.

API-ключ Genesis API — строка вида gns_live_…, которая работает как пароль: по ней сервер узнаёт ваш аккаунт и тариф. Ключ передают в каждом запросе в HTTP-заголовке X-API-Key; без ключа или с неверным ключом API отвечает 401 invalid_key. На аккаунт выдаётся один ключ, его получают, перевыпускают и отзывают в профиле Genesis Arbitrage.

Где находится ключ

Ключом управляют в профиле, в блоке «Genesis API» — остальные блоки профиля описаны в инструкции «Профиль аккаунта». Блок показывает подписку на API и состояние ключа:

Что видно в блокеЧто это значит
«Подписка не активна», кнопка «Оформить»Тариф API не оформлен, кнопка ведёт к тарифам
«Подписка активна», «Действует до …», кнопка «Продлить»Тариф работает до указанной даты
«Подписка истекла», кнопка «Продлить»Срок вышел: ключ не принимается, кнопки ключа скрыты до продления
«Ключ ещё не создан», кнопка «Получить ключ»Подписка есть, ключа пока нет
«API-ключ» и gns_live_…Начало действующего ключа; целиком ключ больше не показывается
«создан …» · «использован …»Когда ключ создан и когда с ним был последний запрос
«Использовано вызовов», «запр/сек», «свежесть», «сброс …»Расход квоты, лимит запросов в секунду, задержка данных и дата обнуления счётчика

Ссылка «Документация» в углу блока открывает документацию Genesis API. Как устроены квота и лимиты, разобрано в инструкции о лимитах Genesis API.

Как получить ключ

  1. Оформите тариф API

    На странице «Тарифы Genesis API» выберите Trial, Start, Pro или Max и срок, нажмите «Оформить подписку» и оплатите счёт криптовалютой. Статус в профиле сменится на «Подписка активна».

  2. Нажмите «Получить ключ»

    Кнопка видна в блоке «Genesis API», пока ключа нет. Ключ создаётся сразу.

  3. Сохраните ключ из окна «Ваш API-ключ»

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

  4. Проверьте ключ запросом

    Вызовите /account/usage, как в примерах ниже. Ответ 200 с вашим тарифом в data.plan означает, что ключ принят.

Как передать ключ в запросе

Ключ передают только в заголовке X-API-Key. Ключ в параметрах адреса или в заголовке Authorization сервер не читает и отвечает 401. В примерах ключ берётся из переменной окружения GENESIS_API_KEY, базовый адрес — https://api.genesisarbitrage.com/v1.

curl:

# ключ подставляется из переменной окружения
curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: $GENESIS_API_KEY"

Python 3.10+ с библиотекой requests:

import os

import requests

# os.environ[...] падает сразу, если переменная не задана
key = os.environ["GENESIS_API_KEY"]

r = requests.get(
    "https://api.genesisarbitrage.com/v1/account/usage",
    headers={"X-API-Key": key},
    timeout=10,
)
r.raise_for_status()
print(r.json()["data"]["plan"])

JavaScript, Node.js 18+ со встроенным fetch:

// файл .mjs: в модуле await работает на верхнем уровне
const key = process.env.GENESIS_API_KEY;
if (!key) throw new Error('GENESIS_API_KEY не задан');

const res = await fetch(
  'https://api.genesisarbitrage.com/v1/account/usage',
  { headers: { 'X-API-Key': key } },
);
const body = await res.json();
console.log(res.status, body.data?.plan);

Ответ на все три запроса одинаков (значения условные):

{
  "success": true,
  "data": {
    "plan": "pro",
    "calls_used": 184201,
    "calls_limit": 5000000,
    "rps_limit": 5,
    "freshness_sec": 10,
    "period_resets_at": 1786492800
  },
  "meta": { … }
}

Поля ответа описаны в разделе документации «Использование».

Где хранить ключ

Ключ Genesis API даёт только чтение данных: торговать или выводить средства с ним нельзя. Риск утечки в другом: чужие программы израсходуют вашу квоту и займут ваш лимит запросов в секунду.

МестоМожноПочему
Переменная окружения на сервереДаКлюча нет ни в коде, ни в репозитории
Файл .env, внесённый в .gitignoreДаЕго читают python-dotenv (load_dotenv()) и node --env-file=.env в Node.js 20.6+
Защищённые переменные хостинга и CIДаПлатформа передаёт ключ программе при запуске; в GitHub Actions — Secrets репозитория через env шага
Менеджер паролейДаЗапасная копия для человека
Адрес запросаНетАдреса пишутся в журналы серверов и прокси и в историю браузера
Код сайта, расширения, мобильного приложенияНетКлюч увидит любой, кто откроет код страницы или распакует приложение
Публичный репозиторийНетКлюч остаётся в истории коммитов, даже если файл удалить
Скриншоты, переписка, обращения в поддержкуНетСообщения и картинки пересылают дальше

Если данные нужны в браузере — на дашборде или в расширении, — к Genesis API обращается ваш сервер, а браузер получает от него готовый результат. В поддержку присылают X-Request-Id из ответа, время запроса в UTC, эндпоинт и статус, ключ не нужен. Ключи бирж с правом торговли опаснее; как их ограничивать, описано в статье «Как защитить аккаунт на криптобирже».

Перевыпуск и отзыв

КнопкаЧто происходитКогда нажимать
«Перевыпустить»Старый ключ сразу перестаёт работать, окно «Ваш API-ключ» показывает новыйКлюч утёк или потерян, доступ был у человека, который ушёл
«Отозвать»Ключ отключён без замены, доступ к API закрыт; в блоке снова «Получить ключ»Ключ больше не нужен

Обе кнопки сначала спрашивают подтверждение — «Перевыпустить ключ? Текущий ключ перестанет работать немедленно.» или «Отозвать ключ? Он сразу перестанет работать, доступ к API будет закрыт.» — с кнопками «Отмена» и «Подтвердить». Если ключ утёк:

  1. Перевыпустите ключ

    Нажмите «Перевыпустить», затем «Подтвердить» и сохраните новый ключ из окна «Ваш API-ключ». Запросы со старым ключом с этого момента получают 401.

  2. Замените ключ во всех программах

    Обновите переменные окружения, .env, защищённые переменные CI и хостинга, затем перезапустите программы: процесс читает окружение при старте. Если программа всё ещё шлёт старый ключ, проверьте, не задан ли GENESIS_API_KEY в окружении: python-dotenv и node --env-file не перезаписывают уже заданную переменную значением из .env.

  3. Проверьте расход вызовов

    Строка «Использовано вызовов» в профиле или запрос к /account/usage покажет, сколько вызовов потрачено за период. Перевыпуск счётчик не обнуляет.

Ответ 401 invalid_key: что проверить

Сервер отвечает 401 с кодом invalid_key, когда ключа нет, он неверен, отозван или подписка истекла:

{
  "success": false,
  "error": {
    "code": "invalid_key",
    "message": "Missing X-API-Key header."
  }
}

Если заголовок дошёл, а ключ не принят, в message перечислены все причины разом. Ответ 403 plan_restricted означает другое: ключ принят, но эндпоинт не входит в тариф. Остальные коды — в разделе «Ошибки» и в инструкции об ответах и ошибках Genesis API.

Форма «Проверить запрос» в документации

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

Браузер запоминает ключ, и при следующем визите поле заполнится само, поэтому на чужом компьютере формой не пользуйтесь. Запрос из формы — обычный вызов API: квоту и лимит запросов в секунду он расходует так же, как запрос из кода. Первый запрос из кода с разбором ответа — в инструкции «Быстрый старт с Genesis API».

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

Можно ли завести отдельный ключ для каждого бота?

Нет, на аккаунт выдаётся один ключ. Все программы с ним делят квоту вызовов и лимит запросов в секунду. Не хватает лимитов — повысьте тариф: заводить несколько аккаунтов ради обхода лимитов — нарушение правил.

Обнулится ли счётчик вызовов после перевыпуска?

Нет. «Использовано вызовов» считается по подписке аккаунта, а не по ключу: новый ключ продолжает тот же 30-дневный период.

Можно ли писать заголовок строчными буквами — x-api-key?

Да. Имена HTTP-заголовков не зависят от регистра — это правило RFC 9110, раздел 5.1. Сам ключ передаётся без изменений.

Нужен ли новый ключ после продления подписки?

Нет. Пока подписка истекла, ключ получает 401, а после «Продлить» тот же ключ снова работает.