GMGN Agent API: подключение и права

Обновлено: 4 ноября 2026 г.

GMGN Agent API даёт агенту доступ к данным токенов, рыночным свечам, спискам Trending и портфелю кошелька. Отдельная функция Swap выполняет обмен через кошельки GMGN и требует дополнительных секретов и разрешений.

Что подготовить

Создайте асимметричную пару ключей локально. Приватная часть остаётся у вас.
Откройте раздел AI GMGN, загрузите публичный ключ и создайте API Key.
Настройте текущие Skills или CLI GMGN. Для чтения используется GMGN_API_KEY. Для swap дополнительно требуется GMGN_PRIVATE_KEY той же пары, публичная часть которой была загружена.
Проверьте запрос данных по одному адресу и одной сети. Не включайте отправку обменов на этапе проверки чтения.

Подключение и команды клиента описаны в официальном руководстве GMGN Agent API. Формат ключей и список сетей берите для выбранного интерфейса: профессиональный Trading API использует другой порядок выдачи ключа.

Функции данных

Token предоставляет параметры токена, цену, ликвидность, результаты проверок и информацию о крупных держателях и трейдерах. Market возвращает свечи с разрешениями 1m–1d. Trending возвращает текущие популярные токены. Portfolio позволяет читать балансы и историю активности кошелька.

В опубликованном списке Agent API поддерживаются Solana, BSC и Base; Ethereum отмечена как интеграция в работе. Список сетей веб-терминала нельзя автоматически переносить в API. Для исходящих запросов заявлена поддержка IPv4.

Контроль обменов

Swap использует маршрутизацию обмена и поддерживает параметры проскальзывания. До отправки проверяйте сеть, адрес токена, сумму, кошелёк, минимальный выход и комиссию. Включите собственные ограничения суммы и разрешённых активов. Ответ клиента проверяйте по статусу операции и транзакции в блокчейне.

Модель этой интеграции использует кошельки GMGN. Не считайте её эквивалентом подтверждения каждой сделки во внешнем Phantom. Автоматический агент может неверно понять запрос или выбрать параметры; проверка должна происходить до исполнения.

FAQ

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

Для функций чтения документирован API Key. Приватный ключ дополнительно требуется для Swap.

Где хранить конфигурацию?

В закрытом конфигурационном файле вне публичного кода и журналов. В официальном примере используется ~/.config/gmgn/.env; секреты не передаются в HTML страницы.

Что делать, если запрос завис?

Для чтения проверьте сеть и ключ. Для обмена сначала сверяйте статус первой операции: таймаут может произойти после исполнения. Не выполняйте повторный swap автоматически без проверки.