兑换 API

兑换 API 允许您直接从 Blockradar 钱包将一种稳定币兑换为另一种。兑换可从主钱包或子地址发起。

功能概述

方法	端点	描述
`POST`	`/v1/wallets/{walletId}/swaps/quote`	从主钱包获取兑换报价
`POST`	`/v1/wallets/{walletId}/swaps/execute`	从主钱包执行兑换
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/quote`	从子地址获取兑换报价
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/execute`	从子地址执行兑换

参数	类型	是否必填	描述
`recipientAddress`	string	否	外部收款人地址。即使是 Stellar `G...` 和 `M...` 地址，它仍然是字符串。
`recipientRouting`	object	否	仅用于 Stellar 的路由：`{ type: "none" }` 或 `{ type: "memo_id", value: "<numeric string>" }`。

只有当目标链为 Stellar 时，才支持 recipientRouting。EVM、Solana 和 Tron 目标的请求不得发送该字段；如果包含该字段，请求会被拒绝。客户端不得发送或公开单独的收款人 memo 字段。对于受支持的 Stellar USDC 目标：

对于 muxed M... 地址，请省略 recipientRouting：路由 ID 已嵌入地址，提供路由数据会被拒绝。
对于带路由 ID 的基础 G... 地址，请发送 { type: "memo_id", value: "123" }。value 必须是介于 0 和 18446744073709551615 之间的非空数字字符串。地址会在请求报价或执行前规范化为 M...。
对于不带路由 ID 的基础 G... 地址，请发送不含 value 的 { type: "none" }。没有 recipientRouting 的 G... 地址会被拒绝，目标基础账户必须在报价或执行前拥有 Stellar USDC trustline。
对于默认的 Blockradar Stellar 钱包，请显式发送 { type: "none" }。

报价响应可以包含 data.recipientRouting，其中含有 status: "none" 或 "embedded" 以及说明消息。执行响应不包含这些元数据。

旧字段	替代方式
`recipientMemoId`	`recipientRouting: { type: "memo_id", value: "<numeric string>" }`
`stellarMemoNotRequired: true`	`recipientRouting: { type: "none" }`

在 API 参考选项卡中查看所有兑换端点。