Genesis Arbitrage

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

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).

Как хранить ключ

Ключ биржи и ключ Genesis API

Ключ биржиКлюч Genesis API
ПраваЧтение, торговля, вывод — что включитеТолько чтение данных
Утечка грозитСделками и выводом с аккаунтаРасходом квоты вызовов
ЗащитаБез права вывода, привязка к IPПеревыпуск в профиле

Ключ Genesis API даёт только чтение: ордеров через него не поставить и денег не вывести. Ответы на ошибки ключа и их коды — в разделах «Аутентификация» и «Ошибки».

Смотрите также: API, эндпоинт, лимит запросов, API-ключ: получить, хранить, перевыпустить, отозвать.

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

Можно ли сделать несколько ключей Genesis API?

Нет, у аккаунта один ключ. «Перевыпустить» выдаёт новый ключ и сразу отключает старый.

Где взять ключ Genesis API?

В профиле, в блоке «Genesis API», после оплаты тарифа API. Кнопка «Получить ключ» откроет окно «Ваш API-ключ» с кнопкой «Копировать».