GMGN Solana Trading API: как устроена интеграция
Обновлено:
Trading API GMGN позволяет получить маршрут обмена и подготовленную транзакцию Solana. Приложение проверяет параметры, подписывает транзакцию и отслеживает её результат в блокчейне.
Доступ и аутентификация
Доступ к профессиональному Trading API предоставляется после рассмотрения заявки. Ключ выдаёт GMGN; его передают в заголовке x-route-key. В опубликованной инструкции для этого интерфейса указан лимит один запрос в пять секунд на ключ. Эти условия относятся к Trading API; ключи и порядок подключения Agent API отличаются.
Последовательность обмена
- Задайте входной и выходной mint-адрес, адрес кошелька и сумму в минимальных единицах токена. Для SOL это lamports.
- Запросите маршрут. Проверьте получаемое количество, допустимое проскальзывание, влияние сделки на цену и комиссии.
- Проверьте подготовленную транзакцию и подпишите её разрешённым кошельком. API Key не заменяет подпись.
- Передайте подписанную транзакцию предусмотренным методом отправки. Сохраните её hash и срок действия.
- Опросите статус и проверьте результат в обозревателе Solana. Ответ об отправке ещё не означает успешное исполнение.
Названия методов, параметры и примеры запроса приведены в официальной инструкции Trading API для Solana. Копируйте актуальный контракт оттуда: универсальные пути /trade/buy и /trade/sell с Bearer-токеном здесь не документированы.
Ошибки и повторная отправка
Разделяйте состояния: транзакция успешно включена в блок, включена с ошибкой или истекла. Перед повтором проверьте hash первой попытки. Сетевой таймаут клиента может произойти после успешной сделки; повтор без сверки способен выполнить второй обмен.
Проскальзывание и приоритетные комиссии задают отдельно. Anti-MEV использует свои параметры; минимальная комиссия и маршрут зависят от выбранного режима. Проверяйте их перед подписью.
FAQ
Можно ли получить свечи этим методом?
Маршрутизация обмена и рыночные данные — разные задачи. Для данных используйте соответствующие функции Agent API или страницу о графиках и свечах.
Нужна ли подпись для чтения котировки?
Запрос маршрута не выполняет сделку. Для отправки обмена требуется подписанная транзакция и средства на сетевые комиссии.
Что хранить в журнале?
Адреса токенов, параметры без секретов, hash и результат проверки статуса. Ключи API, приватные ключи и содержимое секретных конфигураций исключайте из журнала.