快速开始
5 条 curl 命令，从零完成一笔可追踪的跨链订单。Direct API 面向已审核 Partner 集成；可在这里申请。
沙盒 vs 正式。 先用 sandbox 密钥验证 HTTP 流程。存款地址 UI、memo 处理和状态跟踪通过 review 后，再切换到 live 密钥。
1. 获取 API 密钥
每次请求需要两个 header：X-Key-Id 标识密钥，Authorization: Bearer 携带密文。密文必须只放服务端，不能进入浏览器。
X-Key-Id: ak_live_yourapp
Authorization: Bearer sk_live_REPLACE_ME
Content-Type: application/json更多细节见 身份验证，包括密钥轮换和 scope 行为。
2. 列出可路由资产
资产使用 CAIP-19 标识。保存返回的 assetId；后续作为 originAsset 和 destinationAsset 传入。
curl https://api.allswap.io/v1/assets \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..."3. 预览报价
传 dry: true 获取不具约束力的预览。响应返回 provider 候选、best provider、目标金额、费用估算和 ETA。
curl -X POST https://api.allswap.io/v1/quote \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"originAsset": "eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7",
"destinationAsset": "tron:mainnet/trc20:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"amount": "1000000000",
"sender": "0xYourSourceAddress",
"recipient": "TYourDestinationAddress",
"dry": true
}'amount 永远使用源资产最小单位。用户确认前应刷新一次预览，因为流动性和 provider 可用性会快速变化。
4. 创建订单
把用户接受的路由连同 providerId 一起提交。Allswap 返回一次性 depositAddress；如果有 depositMemo，必须和地址一起展示，并要求用户同时复制。
curl -X POST https://api.allswap.io/v1/order \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"originAsset": "eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7",
"destinationAsset": "tron:mainnet/trc20:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"amount": "1000000000",
"sender": "0xYourSourceAddress",
"recipient": "TYourDestinationAddress",
"providerId": "route_A"
}'存款地址模式。 你的应用不负责签名交易。用户从自己的钱包向存款地址转账；检测到入金后，Allswap 执行后续兑换。
5. 跟踪状态
每 10-15 秒轮询 GET /v1/order/{id} 直到终态；Partner 账号开通后也可以使用 webhook。
curl https://api.allswap.io/v1/order/ord_01HW9... \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..."