Генерация публичного ключа (API)

Для работы с торговым API (Trading API) или Data API GMGN вам необходимо сгенерировать пару ключей (Public Key / Secret Key) для авторизации ваших запросов.

Зачем нужны ключи?

API ключи обеспечивают безопасность взаимодействия вашего скрипта/бота с нашими серверами. С их помощью платформа идентифицирует ваш аккаунт, отслеживает лимиты (rate limits) и гарантирует, что торговые операции инициированы именно вами.

Шаги по генерации (Generate Public Key)

Войдите в свой аккаунт на сайте GMGN.ai.
Перейдите в раздел Developer Settings (Настройки разработчика) или вкладку API Management.
Нажмите кнопку Create New API Key (Создать новый ключ).
Введите название для ключа (например, My Python Trading Bot).
Установите права (Permissions):
- Read Data — только для получения котировок и аналитики.
- Trade — для совершения свопов и выставления лимитных ордеров (требует дополнительной аутентификации).
Сохраните Secret Key! Он будет показан только один раз. Если вы его потеряете, ключ придется перевыпускать.

Внимание: Никогда не публикуйте ваш Secret Key в открытых репозиториях на GitHub или в публичных чатах. Любой, кто получит к нему доступ, сможет совершать сделки от имени вашего аккаунта (если разрешено право Trade).

Использование в коде

Передавайте ваш публичный ключ в заголовках (headers) HTTP-запросов:

headers = {
    "X-API-Key": "ВАШ_ПУБЛИЧНЫЙ_КЛЮЧ",
    "Content-Type": "application/json"
}

Для методов, требующих подписи (Trade API), вам нужно будет подписывать полезную нагрузку (payload) вашим Secret Key по алгоритму HMAC-SHA256. Подробные примеры кода есть в разделе Trading API (Python).