用途:基于 NEAR Intents 的 1Click REST API 实现跨链代币兑换集成,适用于构建兑换组件、跨链桥界面以及 EVM、Solana、NEAR、TON、Tron、Stellar 等多链转账。
主要能力:提供代币列表查询、报价、存款提交、状态轮询等 API;支持链到链默认兑换、ANY_INPUT 报价提现查询、限价单、机密兑换、用户认证与私有余额、Hyperliquid 出入金等高级功能;提供官方 TypeScript/Go/Rust 客户端库。
使用方式:集成流程为 GET /v0/tokens → POST /v0/quote(dry 预览)→ POST /v0/quote(dry=false 获取存款地址)→ 构建并发送存款交易 → POST /v0/deposit/submit → GET /v0/status 轮询至终态。React 应用可参考 react-swap-widget.md,Node.js 脚本参考 server-example.md。
关键规则:assetId 必须取自 /v0/tokens,不可手动构造;dry:true 仅预览,dry:false 返回存款地址(约 10 分钟有效);状态需轮询至终态 SUCCESS、FAILED、REFUNDED、INCOMPLETE_DEPOSIT,进行中状态包括 PENDING_DEPOSIT、KNOWN_DEPOSIT_TX、PROCESSING;depositType 与 recipientType 默认使用链端点。
限制:未使用 API 密钥时,每个非 ANY_INPUT 报价会额外收取 25 bps(0.25%)费用;Stellar 转账必须填写 MEMO。文档地址:https://docs.near-intents.org/integration/distribution-channels/1click-api,API 密钥申请:https://partners.near-intents.org/,OpenAPI:https://1click.chaindefuser.com/docs/v0/openapi.yaml。