Данные GMGN для анализа токенов и кошельков
Обновлено:
Для программной работы с данными GMGN используйте документированный интерфейс Agent API. Его основные группы — Token, Market, Trending и Portfolio. Они отличаются от методов подготовки и отправки торговой транзакции.
Какие данные получать
| Группа | Задача | Что проверять |
|---|---|---|
| Token | Цена, ликвидность, параметры токена, проверки контракта и крупные участники | Сеть, mint/контракт, время обновления |
| Market | Свечи с разрешениями от 1m до 1d | Интервал, диапазон времени, пустые участки |
| Trending | Текущий список популярных токенов | Сеть и критерии списка; популярность не равна качеству |
| Portfolio | Балансы токенов и история активности кошелька, PnL | Охват операций, переводы и учитываемые комиссии |
Как подключить чтение
- Создайте пару ключей локально, загрузите публичную часть и выпустите API Key в разделе AI GMGN.
- Настройте поддерживаемый клиент, Skills или CLI. Для чтения достаточно API Key; приватный ключ требуется дополнительно для swap.
- Задайте конкретный адрес и сеть. В опубликованном описании Agent API перечислены SOL, BSC и Base; ETH отмечена как интеграция в работе.
- Сначала сохраните небольшой ответ и проверьте значения по интерфейсу и обозревателю блокчейна.
- Организуйте повторные запросы с учётом актуальных ограничений доступа. Не смешивайте лимиты Agent API и профессионального Trading API.
В описании GMGN Agent API указаны поддерживаемые клиенты и права. Оно не фиксирует полный HTTP-контракт каждого метода; перед разработкой сверяйте параметры и схему ответа в текущем клиенте. Ранее приведённые на этой странице универсальные пути /wallet/history и /token/.../candles не следует считать подтверждёнными методами GMGN.
Как интерпретировать ответ
Отсутствующее поле не равно нулю. Для PnL — результата торговли — важны стоимость приобретения, внешние переводы, комиссия и доступная история. Цена токена и баланс дают оценку позиции, но не гарантируют сумму её продажи.
Записывайте время ответа и идентификатор сети. Сверяйте единицы сумм и decimals; не объединяйте одноимённые токены из разных сетей. Автоматический security flag отражает проверенное состояние и не заменяет исследование контракта.
FAQ
Можно ли получить JSON из встроенного графика?
Для iframe предусмотрена страница графика. Числовые свечи получают через интерфейс данных; см. встраивание графика и API свечей.
Почему список полей меняется?
Охват зависит от метода, сети и версии клиента. Проверяйте отсутствующие значения и совместимость до обновления обработки.
Подходит ли ключ для чтения к торговле?
Сам по себе ключ чтения не подтверждает возможность выполнить обмен. Swap требует дополнительных прав и подписи; настраивайте это отдельно.