Skip to main content
L2Pass SwapKit API, cüzdanların, uygulamaların ve yapay zekâ ajanlarının kendi ürünlerine cross-chain takas eklemesini sağlar. L2Pass RFQ by NEAR Intents ile aynı şekilde çalışır: teklif istersiniz, tek kullanımlık bir yatırma adresi alırsınız ve kullanıcı herhangi bir cüzdan veya borsadan öder. API her teklif için platform ücretini, partner ücretinizi ve net çıktıyı döndürür, durum değişikliklerini imzalı webhook’larla bildirir. Erişim için onboarding sırasında verilen bir partner API anahtarı gerekir. Referans dokümanlar api.l2pass.com/docs adresindedir.

Neler oluşturabilirsiniz

Bir ağda token alıp başka bir ağda teslim eden her ürün API’yi kullanabilir.
  • Cüzdanlar: Tron, Solana, Bitcoin ve Zcash dahil, cüzdanınızın içinde cross-chain stablecoin takasları.
  • Ödeme uygulamaları: bir ağda USDT kabul edip başka bir ağda mutabakat yapın.
  • Borsalar ve satıcılar: herhangi bir cüzdan veya borsadan çalışan yatırma adresi akışları.
  • Yapay zekâ ajanları: REST API üzerinden takas teklifi alın ve gerçekleştirin.

Uç noktalar

Yedi REST uç noktası varlıkları, tahminleri, teklifleri, durumu ve partner hesabınızı kapsar. Temel URL: https://api.l2pass.com. Anahtarınızı X-API-Key başlığında gönderin. Tam OpenAPI spesifikasyonu API referansında bulunur.

API üzerinden takas nasıl çalışır

API takası, uygulamadaki takasla aynı akışı izler: teklif, yatırma, durum.
1

Tahmin alın

Kullanıcıya ne alacağını göstermek için kaynak ve hedef varlıklar ile tutarla POST /v1/swap/estimate çağırın.
2

Teklif isteyin

Alıcı ve iade adresleriyle POST /v1/swap/quote çağırın. Yanıt, tek kullanımlık bir yatırma adresi ve ücret dökümünü içerir: platform_fee, partner_fee, total_fee ve net_output.
3

Kullanıcının ödemesine izin verin

Kullanıcı teklif edilen tutarı herhangi bir cüzdan veya borsadan yatırma adresine gönderir.
4

Durumu takip edin

GET /v1/swap/status/{quoteId} sorgulayın veya X-Webhook-Signature başlığında HMAC-SHA256 ile imzalanmış webhook’lar alın.

Ücretler, limitler ve iadeler

Partner ücretinizi kendiniz belirlersiniz ve anahtarınızın kendi istek limitleri vardır.
  • Partner ücreti. Kendi ücretinizi ekleyebilirsiniz; her teklifte partner_fee_bps ve partner_fee olarak döner.
  • İstek limitleri. Limitler teklifler ve durum istekleri için partner bazında belirlenir. Limit aşılırsa API, Retry-After başlığıyla 429 döndürür.
  • Anahtar yenileme. Anahtarınızı POST /v1/partner/rotate-key ile yenileyin.
  • İadeler ve hatalar. Bir takas tamamlanamazsa sağlayıcı iade adresine iade eder ve durum REFUNDED olur. İşaretlenen adresler teklif almaz. Ulaştıktan sonra işaretlenen bir yatırma iade edilmez, inceleme için tutulur ve kullanıcı bunu NEAR Intents desteğiyle çözer. Bkz. Tarama nasıl çalışır.

SSS

API anahtarları partner onboarding sırasında verilir. Erişim istemek için L2Pass desteğiyle iletişime geçin.
Hayır. Kullanıcılar teklifleri için tek kullanımlık bir yatırma adresine öder ve takas NEAR Intents üzerindeki çözücüler tarafından gerçekleştirilir. L2Pass kullanıcı token’larını veya özel anahtarlarını asla tutmaz.
Evet. Bir partner ücreti belirleyin; her teklif bunu platform ücretinin yanında partner_fee_bps ve partner_fee olarak döndürür.
Evet, npm’de @l2pass/swapkit-sdk. Ayrıntılar için API referansına bakın.

Bağlantılar

Son güncelleme: 19 Ekim 2026