API-ключ
API-ключ — длинная случайная строка, по которой сервис узнаёт, кто прислал запрос: чей аккаунт, какой тариф, какие данные можно отдать. Для программы ключ работает как пароль: кто знает строку, тот действует от имени владельца.
Как передают ключ
Ключ отправляют в заголовке каждого запроса, а фильтры — в адресе. В Genesis API заголовок называется X-API-Key, ключ имеет вид gns_live_…. Пример запрашивает AI-сигналы с оценкой alpha:
import os
import requests
key = os.environ.get("GENESIS_API_KEY")
if not key:
raise SystemExit("задайте GENESIS_API_KEY на сервере")
r = requests.get(
"https://api.genesisarbitrage.com/v1/ai/signals",
headers={"X-API-Key": key}, # ключ — только в заголовке
params={"category": "alpha"}, # фильтры — в адресе
timeout=10,
)
if r.status_code == 401:
# ключа нет, он неверен или отозван
print(r.json()["error"]["code"]) # invalid_key
elif r.ok:
print("сигналов alpha:", r.json()["meta"]["count"])
Заголовок выбирают потому, что адрес запроса вместе с параметрами оседает в журналах веб-серверов и прокси, а если открыть его в браузере — ещё и в истории. Документация Genesis API прямо говорит: не передавать ключ в параметрах адреса, не встраивать его в код сайта или приложения и делать запросы только со своего сервера. Биржи поступают так же: Binance принимает ключ в заголовке X-MBX-APIKEY, а запросы к аккаунту ещё подписывают вторым ключом (secret key).
Как хранить ключ
- Держите ключ в переменной окружения или в файле
.envна сервере, а.envвнесите в.gitignore. - Не вставляйте ключ в код сайта, мобильное приложение, чат или скриншот.
- Genesis API показывает ключ один раз и хранит только его хеш: потерянный ключ не восстановить, только перевыпустить.
- При утечке нажмите в профиле «Перевыпустить» — старый ключ перестанет работать сразу. «Отозвать» отключает ключ без замены.
Ключ биржи и ключ Genesis API
| Ключ биржи | Ключ Genesis API | |
|---|---|---|
| Права | Чтение, торговля, вывод — что включите | Только чтение данных |
| Утечка грозит | Сделками и выводом с аккаунта | Расходом квоты вызовов |
| Защита | Без права вывода, привязка к IP | Перевыпуск в профиле |
Ключ Genesis API даёт только чтение: ордеров через него не поставить и денег не вывести. Ответы на ошибки ключа и их коды — в разделах «Аутентификация» и «Ошибки».
Смотрите также: API, эндпоинт, лимит запросов, API-ключ: получить, хранить, перевыпустить, отозвать.
Вопросы и ответы
Можно ли сделать несколько ключей Genesis API?
Нет, у аккаунта один ключ. «Перевыпустить» выдаёт новый ключ и сразу отключает старый.
Где взять ключ Genesis API?
В профиле, в блоке «Genesis API», после оплаты тарифа API. Кнопка «Получить ключ» откроет окно «Ваш API-ключ» с кнопкой «Копировать».