Skip to main content
L2Pass SwapKit API позволяет кошелькам, приложениям и AI-агентам добавить кросс-чейн свапы в свой продукт. Он работает так же, как L2Pass RFQ by NEAR Intents: вы запрашиваете котировку, получаете одноразовый адрес депозита, а пользователь платит с любого кошелька или биржи. Для каждой котировки API возвращает комиссию платформы, вашу партнёрскую комиссию и чистую сумму на выходе, а об изменениях статуса сообщает подписанными вебхуками. Для доступа нужен партнёрский API-ключ, который выдаётся при подключении. Справочная документация: api.l2pass.com/docs.

Что можно построить

API подойдёт любому продукту, который принимает токены в одной сети и доставляет в другой.
  • Кошельки: кросс-чейн свапы стейблкоинов внутри вашего кошелька, включая Tron, Solana, Bitcoin и Zcash.
  • Платёжные приложения: принимайте USDT в одной сети и проводите расчёт в другой.
  • Биржи и мерчанты: схемы с адресом депозита, которые работают с любого кошелька или биржи.
  • AI-агенты: получение котировок и исполнение свапов через REST API.

Эндпоинты

Семь REST-эндпоинтов покрывают активы, оценки, котировки, статусы и ваш партнёрский аккаунт. Базовый URL: https://api.l2pass.com. Передавайте ключ в заголовке X-API-Key. Полная спецификация OpenAPI в справочнике API.

Как проходит свап через API

Свап через API идёт по той же схеме, что и в приложении: котировка, депозит, статус.
1

Получите оценку

Вызовите POST /v1/swap/estimate с исходным и целевым активами и суммой, чтобы показать пользователю, сколько он получит.
2

Запросите котировку

Вызовите POST /v1/swap/quote с адресами получателя и возврата. Ответ содержит одноразовый адрес депозита и разбивку комиссий: platform_fee, partner_fee, total_fee и net_output.
3

Дайте пользователю заплатить

Пользователь отправляет сумму из котировки на адрес депозита с любого кошелька или биржи.
4

Отслеживайте статус

Опрашивайте GET /v1/swap/status/{quoteId} или получайте вебхуки, подписанные HMAC-SHA256 в заголовке X-Webhook-Signature.

Комиссии, лимиты и возвраты

Партнёрскую комиссию вы задаёте сами, а у вашего ключа свои лимиты запросов.
  • Партнёрская комиссия. Можно добавить свою комиссию, она возвращается в каждой котировке как partner_fee_bps и partner_fee.
  • Лимиты запросов. Лимиты задаются для каждого партнёра отдельно для котировок и запросов статуса. При превышении API возвращает 429 с заголовком Retry-After.
  • Ротация ключа. Сменить ключ можно через POST /v1/partner/rotate-key.
  • Возвраты и сбои. Если свап не может завершиться, провайдер возвращает средства на адрес возврата, и статус становится REFUNDED. Помеченные адреса не получают котировку. Депозит, помеченный после поступления, не возвращается, а удерживается на проверке, и пользователь решает вопрос через поддержку NEAR Intents. См. Как работает проверка.

FAQ

API-ключи выдаются при подключении партнёра. Чтобы запросить доступ, свяжитесь с поддержкой L2Pass.
Нет. Пользователи платят на одноразовый адрес депозита для своей котировки, а свап исполняют солверы в NEAR Intents. L2Pass никогда не хранит токены или приватные ключи пользователей.
Да. Задайте партнёрскую комиссию, и каждая котировка вернёт её как partner_fee_bps и partner_fee рядом с комиссией платформы.
Да, @l2pass/swapkit-sdk в npm. Подробности в справочнике API.

Ссылки

Последнее обновление: 19 октября 2026 г.