Bạn có thể xây dựng gì
Bất kỳ sản phẩm nào nhận token trên một mạng và giao trên mạng khác đều có thể dùng API.- Ví: hoán đổi stablecoin cross-chain ngay trong ví, bao gồm Tron, Solana, Bitcoin và Zcash.
- Ứng dụng thanh toán: nhận USDT trên một mạng và thanh toán trên mạng khác.
- Sàn và người bán: luồng địa chỉ nạp hoạt động từ bất kỳ ví hoặc sàn nào.
- AI agent: lấy báo giá và thực hiện hoán đổi qua REST API.
Endpoint
Bảy endpoint REST bao gồm tài sản, ước tính, báo giá, trạng thái và tài khoản đối tác.
URL gốc:
https://api.l2pass.com. Gửi khóa trong header X-API-Key. Đặc tả OpenAPI đầy đủ có trong tài liệu tham khảo API.
Hoán đổi qua API hoạt động thế nào
Hoán đổi qua API theo cùng luồng như trong ứng dụng: báo giá, nạp, trạng thái.1
Lấy ước tính
Gọi
POST /v1/swap/estimate với tài sản nguồn, tài sản đích và số lượng để cho người dùng thấy họ sẽ nhận bao nhiêu.2
Yêu cầu báo giá
Gọi
POST /v1/swap/quote với địa chỉ nhận và địa chỉ hoàn tiền. Phản hồi gồm một địa chỉ nạp dùng một lần và chi tiết phí: platform_fee, partner_fee, total_fee và net_output.3
Để người dùng thanh toán
Người dùng gửi số tiền theo báo giá tới địa chỉ nạp từ bất kỳ ví hoặc sàn nào.
4
Theo dõi trạng thái
Truy vấn
GET /v1/swap/status/{quoteId} hoặc nhận webhook ký bằng HMAC-SHA256 trong header X-Webhook-Signature.Phí, giới hạn và hoàn tiền
Bạn tự đặt phí đối tác, và khóa của bạn có giới hạn yêu cầu riêng.- Phí đối tác. Bạn có thể thêm phí riêng, được trả về dưới dạng
partner_fee_bpsvàpartner_feetrong mỗi báo giá. - Giới hạn yêu cầu. Giới hạn được đặt theo từng đối tác cho báo giá và truy vấn trạng thái. Vượt giới hạn, API trả về 429 kèm header
Retry-After. - Xoay khóa. Đổi khóa bằng
POST /v1/partner/rotate-key. - Hoàn tiền và lỗi. Nếu hoán đổi không thể hoàn tất, nhà cung cấp hoàn tiền về địa chỉ hoàn tiền và trạng thái chuyển thành REFUNDED. Địa chỉ bị gắn cờ không nhận được báo giá. Khoản nạp bị gắn cờ sau khi đến sẽ bị giữ để xem xét thay vì hoàn trả, và người dùng giải quyết với hỗ trợ NEAR Intents. Xem Cách sàng lọc hoạt động.
Câu hỏi thường gặp
Làm sao để có API key?
Làm sao để có API key?
API key được cấp khi onboarding đối tác. Liên hệ hỗ trợ L2Pass để yêu cầu quyền truy cập.
API có giữ tiền của người dùng không?
API có giữ tiền của người dùng không?
Không. Người dùng thanh toán vào địa chỉ nạp dùng một lần cho báo giá của họ, và hoán đổi được các solver trên NEAR Intents thực hiện. L2Pass không bao giờ giữ token hay khóa riêng tư của người dùng.
Tôi có thể kiếm phí từ hoán đổi không?
Tôi có thể kiếm phí từ hoán đổi không?
Có. Đặt phí đối tác, và mỗi báo giá sẽ trả về nó dưới dạng
partner_fee_bps và partner_fee bên cạnh phí nền tảng.Có SDK không?
Có SDK không?
Có,
@l2pass/swapkit-sdk trên npm. Xem tài liệu tham khảo API để biết chi tiết.Liên kết
- Tài liệu tham khảo API
- L2Pass RFQ by NEAR Intents là gì
- Giải thích phí L2Pass Swap
- Giới thiệu và điều kiện theo khối lượng
- Liên hệ hỗ trợ