RWA 交易
Bitget Wallet 交易 API 已接入链上 RWA(Real World Assets,现实世界资产)流动性,支持任意链上代币(AnyToken)与代币化美股等 RWA 资产(RWA Token)的双向兑换。
接入的 RWA 流动性
目前已对接 Reality 、Ondo Finance 、XStocks 等流动性,更多将陆续开放。询价或下单时,在 fromContract、toContract 中填入对应链上的 RWA Token 合约地址即可。聚合层会按资产自动选路,无需为各流动性单独配置参数,也无需手动指定走询价(RFQ)还是资金池(AMM)。
Reality
Reality 提供代币化的美股、ETF 等资产(rToken),底层由 Alpaca 1:1 足额托管。
- 常见链:Arbitrum、Morph(以询价返回为准)。
- 路由方式:以官方 RFQ(询价)为主,由聚合层完成 AnyToken 与 rToken 的兑换。
- 使用注意:询价有时效,建议在用户签名前定期刷新;美股休市期间可能无法报价。
Ondo Finance
Ondo Finance 提供代币化的美元、美股、贵金属、美债等资产。
- 常见链:ETH、Base、Solana、BNB 等(以询价返回为准)。
- 路由方式:以官方 RFQ(询价)为主,由聚合层完成 AnyToken 与 RWA 的兑换。
- 使用注意:询价有时效,建议在用户签名前定期刷新;美股休市期间可能无法报价。
XStocks
XStocks 提供代币化的美股、贵金属等资产。
- 常见链:Solana、ETH、TON、Ink、BSC、Mantle 等(以询价返回为准)。
- 路由方式:可能经官方 AMM 资金池或与其他链上流动性组合,以询价返回为准。
- 使用注意:部分 Token 采用 Rebase 机制,分红会反映为持仓数量变化;请关注池子深度与滑点。合约地址与链 ID 请以资产列表或行情 API 为准。
平台能力
任意 Token 与 RWA 资产的兑换
RWA 流动性的原生询价通常只覆盖少数固定交易对,无法直接把用户手中的任意代币一步换成 RWA。Bitget Wallet 聚合器在询价时会自动把多路做市商的报价拼装为多跳路径,接入方只需传入 AnyToken 与 RWA Token 的合约地址,即可完成两端的双向兑换,由聚合层处理中间跳。
整笔成交
多跳路径如果把不同类型的流动性随意拼接,容易出现部分成交或报价过期导致上链失败。Bitget Wallet 在涉及 RWA 的路径上采用统一的询价撮合方式,让每一跳的输入、输出数量在组单时即已确定,整笔交易按报价数量一次性完成,减少「半成交」和路径对不齐的情况。
集成时请注意
- 询价会过期:建议约每 5 秒刷新后再让用户签名;休市期间 Ondo 等可能无法报价。
- 以询价为准:支持哪些链、走 RFQ 多跳还是 AMM,均以当次
/quote或getSwapPrice的返回为准,不要在客户端写死路径类型。 - XStocks Rebase:持仓数量可能随分红变化,展示与对账时需按 Token 规则处理。
- 滑点与深度:池子或路径较浅时,请关注
priceImpact、滑点设置和最小成交额限制。
接入模式
RWA 兑换复用通用 Swap 的接口与流程,指令模式 与 订单模式 均已支持。如需在两者之间选择,请参考 交易 API 概览。
RWA 分红领取(claim)
生成 Reality RWA 分红领取所需的交易数据(contract + calldata),由接入方在客户端签名后广播上链;本接口不代发交易。
请求路径: /bgw-pro/swapx/pro/rwa/claim
请求方法: POST
请求参数:
| 字段名 | 字段类型 | 是否必传 | 字段说明 |
|---|---|---|---|
| address | string | 是 | 用户 EVM 钱包地址 |
| chain | string | 是 | 链标识,如 arbitrum;须为已开通 claim 的链 |
请求参数示例:
{
"address": "0xd8FeBD1C242a282f1b8226d34282942F6F63248b",
"chain": "arbitrum"
}响应说明:
| 参数名称 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| status | number | 必须 | 请求码,0 为成功 |
| data | object | 必须 | - |
| claims | array | 必须 | 可领取分红交易列表;暂无可领时为空数组 [] |
| claims[].sourceAsset | string | 非必须 | 分红来源资产标识 |
| claims[].payoutAsset | string | 非必须 | 分红发放资产标识 |
| claims[].unclaimed | string | 非必须 | 待领取数量 |
| claims[].contract | string | 非必须 | 分红分发合约地址(交易 to) |
| claims[].calldata | string | 非必须 | 领取交易 calldata |
| claims[].value | string | 非必须 | 原生币附带金额,当前为 "0" |
响应示例:
{
"status": 0,
"error_code": 0,
"data": {
"claims": [
{
"sourceAsset": "0xSourceAsset...",
"payoutAsset": "0xPayoutAsset...",
"unclaimed": "12.345678901234567",
"contract": "0xDistributor...",
"calldata": "0x...",
"value": "0"
}
]
},
"msg": "success"
}注意事项:


