GMGN Trading API для Ethereum, Base и BSC
Обновлено:
Обмен в EVM-сетях требует выбора маршрута, проверки проскальзывания и gas, симуляции и отправки подписанной транзакции. Выбирайте сеть явно: одинаковый адрес в разных сетях не означает один и тот же актив.
Получение доступа
Профессиональный Trading API требует одобренной GMGN заявки. Ключ передают заголовком x-route-key; опубликованный лимит составляет один запрос в пять секунд на ключ. Условия доступа и список разрешённых сетей проверяйте при подключении.
Как подготовить обмен
- Укажите сеть, адреса токенов и сумму с учётом decimals.
- Получите доступные маршруты, рекомендуемое проскальзывание и gas для этой сети.
- Выберите маршрут и проверьте ожидаемый выход, комиссии и получателя.
- Выполните симуляцию. Проверьте её результат и необходимые разрешения токена.
- Подпишите проверенную транзакцию и отправьте через выбранный RPC. Сохраните hash.
- Проверьте receipt: успешное принятие запроса не равно подтверждённому обмену.
Методы маршрутизации, симуляции и рекомендуемых параметров описаны в документации GMGN для ETH/Base/BSC. Не переносите параметры Solana в EVM-запрос: единицы, подпись и модель комиссий отличаются.
Разрешения и расходы
Для ERC-20 может потребоваться allowance — разрешение конкретному spender расходовать токен. Сверьте spender с выбранным маршрутом; unlimited approve расширяет риск. Комиссии за approve и swap могут начисляться отдельно. Оставляйте нативный актив сети на gas.
Симуляция снижает риск ошибок, но цена и состояние пула могут измениться до исполнения. Если операция не подтверждается, проверяйте nonce, газ и receipt перед повтором.
FAQ
Подходит ли ключ Agent API?
У профессионального Trading API собственный порядок выдачи и заголовок. Agent API — отдельная интеграция; не подменяйте один формат другим.
Гарантирует ли симуляция результат?
Нет. Она оценивает доступное состояние; финальный результат определяется включённой транзакцией.
Почему повтор может быть опасен?
После таймаута первая операция могла пройти. Сначала сверяйте hash, receipt и баланс, затем решайте, требуется ли новая транзакция.