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.
Как получить ключ
Оформите тариф API
На странице «Тарифы Genesis API» выберите Trial, Start, Pro или Max и срок, нажмите «Оформить подписку» и оплатите счёт криптовалютой. Статус в профиле сменится на «Подписка активна».
Нажмите «Получить ключ»
Кнопка видна в блоке «Genesis API», пока ключа нет. Ключ создаётся сразу.
Сохраните ключ из окна «Ваш API-ключ»
Окно показывает полный ключ один раз. Нажмите «Копировать» и положите ключ в менеджер паролей или сразу в защищённые переменные сервера. После «Готово» целиком его больше не увидеть: у нас хранится только хеш.
Проверьте ключ запросом
Вызовите
/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 будет закрыт.» — с кнопками «Отмена» и «Подтвердить». Если ключ утёк:
Перевыпустите ключ
Нажмите «Перевыпустить», затем «Подтвердить» и сохраните новый ключ из окна «Ваш API-ключ». Запросы со старым ключом с этого момента получают
401.Замените ключ во всех программах
Обновите переменные окружения,
.env, защищённые переменные CI и хостинга, затем перезапустите программы: процесс читает окружение при старте. Если программа всё ещё шлёт старый ключ, проверьте, не задан лиGENESIS_API_KEYв окружении: python-dotenv иnode --env-fileне перезаписывают уже заданную переменную значением из.env.Проверьте расход вызовов
Строка «Использовано вызовов» в профиле или запрос к
/account/usageпокажет, сколько вызовов потрачено за период. Перевыпуск счётчик не обнуляет.
Ответ 401 invalid_key: что проверить
Сервер отвечает 401 с кодом invalid_key, когда ключа нет, он неверен, отозван или подписка истекла:
{
"success": false,
"error": {
"code": "invalid_key",
"message": "Missing X-API-Key header."
}
}
- Заголовок не дошёл. Текст «Missing X-API-Key header.» означает, что ключа в запросе нет совсем. Проверьте имя заголовка и то, задана ли переменная там, где работает программа: на сервере, в контейнере, в задаче планировщика.
- Ключ искажён. Лишний пробел, кавычки внутри значения или обрезанный конец дают
401: ключ должен совпасть символ в символ. - Ключ перевыпущен или отозван. Сравните начало ключа в программе с началом, которое профиль показывает под «API-ключ».
- Подписка истекла. В профиле статус «Подписка истекла». После «Продлить» тот же ключ снова работает, перевыпускать его не нужно.
Если заголовок дошёл, а ключ не принят, в message перечислены все причины разом. Ответ 403 plan_restricted означает другое: ключ принят, но эндпоинт не входит в тариф. Остальные коды — в разделе «Ошибки» и в инструкции об ответах и ошибках Genesis API.
Форма «Проверить запрос» в документации
У каждого эндпоинта в документации есть форма «Проверить запрос». Вставьте ключ в поле «Ваш API-ключ (gns_live_…)» и нажмите «Отправить запрос» — под формой появятся код ответа, время и сокращённый ответ. Ключ хранится только в вашем браузере и уходит только в API.
Браузер запоминает ключ, и при следующем визите поле заполнится само, поэтому на чужом компьютере формой не пользуйтесь. Запрос из формы — обычный вызов API: квоту и лимит запросов в секунду он расходует так же, как запрос из кода. Первый запрос из кода с разбором ответа — в инструкции «Быстрый старт с Genesis API».
Вопросы и ответы
Можно ли завести отдельный ключ для каждого бота?
Нет, на аккаунт выдаётся один ключ. Все программы с ним делят квоту вызовов и лимит запросов в секунду. Не хватает лимитов — повысьте тариф: заводить несколько аккаунтов ради обхода лимитов — нарушение правил.
Обнулится ли счётчик вызовов после перевыпуска?
Нет. «Использовано вызовов» считается по подписке аккаунта, а не по ключу: новый ключ продолжает тот же 30-дневный период.
Можно ли писать заголовок строчными буквами — x-api-key?
Да. Имена HTTP-заголовков не зависят от регистра — это правило RFC 9110, раздел 5.1. Сам ключ передаётся без изменений.
Нужен ли новый ключ после продления подписки?
Нет. Пока подписка истекла, ключ получает 401, а после «Продлить» тот же ключ снова работает.