Проверено: 27 сентября 2026

Графики GMGN: встраивание iframe и API свечей

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

Для отображения графика токена на сайте GMGN предлагает готовую страницу, которую можно вставить через iframe. Для получения свечей в собственное приложение предусмотрен GMGN Agent API. Выбор зависит от результата: нужен посетителю интерактивный график или вашему серверу числовые данные для обработки и собственной визуализации.

Какой способ выбрать

Iframe загружает интерфейс GMGN в отдельном окне внутри страницы. Настройки оформления вашего сайта не применяются к содержимому этого окна. API предоставляет данные, для которых вы самостоятельно организуете хранение, обновление и отрисовку.

Как встроить график через iframe

Формат адреса: https://www.gmgn.cc/kline/{chain}/{token_address}. Замените {chain} на код сети, а {token_address} — на адрес контракта или mint-адрес токена. В примерах встраивания опубликованы sol, eth и bsc.

1. Найдите токен и проверьте его адрес в нужной сети. Одного названия или тикера недостаточно: одинаковые обозначения могут встречаться у разных активов.
2. Откройте полученный адрес графика отдельной вкладкой и убедитесь, что отображается выбранный токен.
3. Добавьте iframe в HTML страницы. Укажите понятный title, ширину и высоту.
4. Проверьте результат на компьютере и телефоне: график должен помещаться в контейнер и оставаться доступным для взаимодействия.

Пример для токена Solana из официальной инструкции:

<iframe
  src="https://www.gmgn.cc/kline/sol/ukHH6c7mMyiWCf1b9pnWe25TSpkDDt3H5pQZgZ74J82?theme=dark&amp;interval=15"
  title="График цены токена в GMGN"
  width="100%"
  height="500"
  style="border:0"
  loading="lazy">
</iframe>

Это образец интеграции; замените адрес токена перед использованием. Параметр theme принимает light или dark. Для interval перечислены 1S, 1, 5, 15, 60, 240, 720, 1D: секундный, минутные и дневной интервалы. Например, 15 задаёт пятнадцатиминутные свечи. Оба параметра можно передать одновременно.

Если окно пустое, сначала проверьте тот же URL отдельно. Затем проверьте высоту контейнера, блокировщики запросов и политику Content Security Policy вашего сайта: директива frame-src должна разрешать домен графика. Актуальный формат и параметры собраны в инструкции по встраиванию GMGN.

Как получить данные свечей через API

В GMGN Agent API функция Market предоставляет свечи с разрешениями от 1m до 1d. Для запросов данных нужен API Key; торговые операции дополнительно требуют приватного ключа. Используйте эти права раздельно при настройке приложения.

Порядок подключения:

1. Создайте локально асимметричную пару ключей и загрузите публичный ключ в разделе AI сайта GMGN для выпуска API Key.
2. Настройте выбранный клиент GMGN. Для официальных Skills ключ задаётся переменной GMGN_API_KEY в файле .env в каталоге ~/.config/gmgn/.
3. Выполните запрос свечей с конкретным адресом токена и сетью. В агентском интерфейсе можно начать с команды: «Получи свечи для указанного токена; только данные, без торговых операций».
4. Проверьте ответ: соответствие токена и сети, временной диапазон, шаг свечей и поля данных. Для своего графика сопоставьте время и цены открытия, максимума, минимума и закрытия с форматом выбранной библиотеки.

Описание GMGN Agent API также предусматривает CLI npx gmgn-cli с выводом JSON и режимом --raw. Точный синтаксис команды свечей, параметры и схему ответа проверяйте в используемом клиенте: обзорная страница не содержит полного HTTP-контракта этого запроса.

Ограничения и FAQ

Совпадают ли сети у iframe и Agent API?

Списки проверяйте отдельно. Для iframe приведены примеры Solana, Ethereum и BSC. Для Agent API перечислены SOL, BSC и Base; интеграция ETH отмечена как находящаяся в работе.

Нужен ли ключ для встроенного графика?

Опубликованная схема встраивания не требует передачи API Key. Для запросов Market через Agent API ключ обязателен. Не помещайте его в iframe, публичный JavaScript или журналы.

Можно ли считать iframe источником JSON?

Адрес /kline/ предназначен для загрузки графика. Для программной обработки свечей используйте интерфейс данных; параметры interval iframe нельзя автоматически переносить в запрос API.

Почему запрос API не проходит?

Проверьте ключ, параметры клиента и сеть исходящего соединения. Agent API поддерживает IPv4; поддержка IPv6 пока не заявлена. Пустой ответ также требует проверки токена и периода. Доступную глубину истории и лимиты уточните перед массовой загрузкой: обзорная страница их не фиксирует.