Skip to Content
Zh CnDocs
交易 API
RWA 交易

RWA 交易

Bitget Wallet 交易 API 已接入链上 RWA(Real World Assets,现实世界资产)流动性,支持任意链上代币(AnyToken)与代币化美股等 RWA 资产(RWA Token)的双向兑换。


接入的 RWA 流动性

目前已对接 Reality Ondo Finance XStocks  等流动性,更多将陆续开放。询价或下单时,在 fromContracttoContract 中填入对应链上的 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,均以当次 /quotegetSwapPrice 的返回为准,不要在客户端写死路径类型。
  • XStocks Rebase:持仓数量可能随分红变化,展示与对账时需按 Token 规则处理。
  • 滑点与深度:池子或路径较浅时,请关注 priceImpact、滑点设置和最小成交额限制。

接入模式

RWA 兑换复用通用 Swap 的接口与流程,指令模式订单模式 均已支持。如需在两者之间选择,请参考 交易 API 概览


RWA 分红领取(claim)

生成 Reality RWA 分红领取所需的交易数据(contract + calldata),由接入方在客户端签名后广播上链;本接口不代发交易。

请求路径: /bgw-pro/swapx/pro/rwa/claim

请求方法: POST

请求参数:

字段名字段类型是否必传字段说明
addressstring用户 EVM 钱包地址
chainstring链标识,如 arbitrum;须为已开通 claim 的链

请求参数示例:

{ "address": "0xd8FeBD1C242a282f1b8226d34282942F6F63248b", "chain": "arbitrum" }

响应说明:

参数名称参数类型是否必填参数说明
statusnumber必须请求码,0 为成功
dataobject必须-
claimsarray必须可领取分红交易列表;暂无可领时为空数组 []
claims[].sourceAssetstring非必须分红来源资产标识
claims[].payoutAssetstring非必须分红发放资产标识
claims[].unclaimedstring非必须待领取数量
claims[].contractstring非必须分红分发合约地址(交易 to
claims[].calldatastring非必须领取交易 calldata
claims[].valuestring非必须原生币附带金额,当前为 "0"

响应示例:

{ "status": 0, "error_code": 0, "data": { "claims": [ { "sourceAsset": "0xSourceAsset...", "payoutAsset": "0xPayoutAsset...", "unclaimed": "12.345678901234567", "contract": "0xDistributor...", "calldata": "0x...", "value": "0" } ] }, "msg": "success" }

注意事项:

  • 仅支持已开通 claim 的链;未开通时返回 80013
  • 接口只返回待签名交易数据,不上链代发;签名广播由接入方完成。
  • 生成失败时返回 80025;其它错误码见 错误码说明

延伸阅读

Last updated on