RWA 行情

对外开放接口（OpenAPI），用于查询链上 RWA（代币化美股等）行情数据。请求鉴权方式见认证。

基本信息

项	值
路由前缀	`/bgw-pro/market/v3/rwa`
Content-Type	`application/json`
响应包裹	`{ "status": 0, "data": ..., "traceId": "..." }`

接口清单

接口	方法	路径	说明
股票详情	`POST`	`/bgw-pro/market/v3/rwa/stockInfo`	股票详情（精简，不返回收藏标识）
校验合约	`POST`	`/bgw-pro/market/v3/rwa/checkContractIsRwa`	判断 chain+contract 是否为 RWA 代币
全量列表	`POST`	`/bgw-pro/market/v3/rwa/stockList`	全量 RWA ticker 及其对应代币（含下线，带状态）
交易列表	`POST`	`/bgw-pro/market/v3/rwa/transactionList`	最简交易列表（分页）
K 线	`POST`	`/bgw-pro/market/v3/rwa/kline`	最简 K 线（按结束时间翻页）

通用响应包裹


{
    "status": 0,
    "data": {},
    "traceId": "xxxx"
}

`status`	说明
`0`	成功
`1`	失败；`data` 为错误信息字符串

失败示例：


{
    "status": 1,
    "data": "chain and contract are required",
    "traceId": "xxxx"
}

公共枚举

数据源 data_source

值	说明
`ondo`	Ondo
`xstocks`	xStocks

Ticker 状态 status

值	说明
`online`	在线
`offline`	已下线

合约状态 status（contracts 内）

值	说明
`online`	在线
`offline`	已下线

市场状态 market_status

值	说明
`open`	开市
`close`	休市

市场状态码 market_status_code（仅 ondo 返回，xStocks 为空）

值	说明
`regular`	盘中
`premarket`	盘前
`postmarket`	盘后
`overnight`	夜盘
`paused`	暂停
`closed`	休市

K 线周期 period

period	含义
`1s` / `5s` / `15s`	秒级（仅 xStocks 支持）
`1m` / `5m` / `15m` / `30m`	分钟级
`1h` / `2h` / `4h` / `6h` / `8h` / `12h`	小时级
`1d` / `3d` / `1w`	天/周级

不传 period 时默认 5m。ondo 不支持秒级周期（1s/5s/15s）及 12h。

股票详情

请求路径: /bgw-pro/market/v3/rwa/stockInfo

请求方法: POST

返回股票详情（参考客户端 Swap StockInfo，去掉收藏标识 is_favorited）。ticker 与 chain+contract 二选一。

请求参数:


{
    "ticker": "TSLA",
    "chain": "",
    "contract": "",
    "has_offline": false
}

字段	类型	必填	说明
`ticker`	string	二选一	股票符号；服务端会做格式化归一
`chain`	string	二选一	链名称；与 `contract` 同时传
`contract`	string	二选一	合约地址
`has_offline`	bool	否	是否包含下线数据，默认 `false`

响应示例:


{
    "status": 0,
    "data": {
        "ticker": "TSLA",
        "name": "Tesla, Inc.",
        "icon": "https://.../tsla.png",
        "latest_price": "228.52",
        "price_24h_change": "1.23",
        "price_24h_change_ratio": "0.0054",
        "chain_assets": [
            {
                "chain": "sol",
                "chain_icon": "https://.../sol.png",
                "chain_name": "Solana",
                "icon": "https://.../token.png",
                "symbol": "TSLAx",
                "name": "Tesla xStock",
                "contract": "XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB",
                "decimals": 8,
                "latest_price": "228.52",
                "price_24h_change": "1.23",
                "price_24h_change_ratio": "0.0054",
                "tx_maximum_buy_usd": "0",
                "tx_minimum_buy_usd": "0",
                "tx_maximum_sell_usd": "0",
                "tx_minimum_sell_usd": "0",
                "data_source": "xstocks",
                "market_status": "open",
                "market_status_title": "Open",
                "market_status_code": ""
            }
        ]
    },
    "traceId": "xxxx"
}

校验合约

请求路径: /bgw-pro/market/v3/rwa/checkContractIsRwa

请求方法: POST

判断指定 chain+contract 是否为 RWA 代币，并返回其 ticker 与数据源（包含下线数据）。

请求参数:


{
    "chain": "sol",
    "contract": "XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB"
}

字段	类型	必填	说明
`chain`	string	是	链名称
`contract`	string	是	合约地址

响应示例:


{
    "status": 0,
    "data": {
        "is_existed": true,
        "stock_ticker": "TSLA",
        "data_source": "xstocks"
    },
    "traceId": "xxxx"
}

未命中时 is_existed 为 false，stock_ticker 与 data_source 为空字符串。

全量列表

请求路径: /bgw-pro/market/v3/rwa/stockList

请求方法: POST

返回全量 RWA ticker 列表及其对应代币合约（包含已下线项，通过 status 标记）。无请求参数。

请求参数:

{}

响应示例:


{
    "status": 0,
    "data": {
        "list": [
            {
                "ticker": "TSLA",
                "name": "Tesla, Inc.",
                "icon": "https://.../tsla.png",
                "status": "online",
                "contracts": [
                    {
                        "chain": "sol",
                        "contract": "XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB",
                        "symbol": "TSLAx",
                        "data_source": "xstocks",
                        "status": "online"
                    }
                ]
            }
        ]
    },
    "traceId": "xxxx"
}

交易列表

请求路径: /bgw-pro/market/v3/rwa/transactionList

请求方法: POST

最简交易列表，支持分页。不支持链下数据。

请求参数:


{
    "chain": "sol",
    "contract": "XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB",
    "side": "",
    "page": 1,
    "size": 20
}

字段	类型	必填	说明
`chain`	string	是	链名称
`contract`	string	是	合约地址
`side`	string	否	`buy`/`sell`；空表示全部
`page`	int	否	页码，默认 `1`
`size`	int	否	每页大小，默认 `20`，超过 `100` 重置为 `20`

响应示例:


{
    "status": 0,
    "data": {
        "list": [
            {
                "side": "buy",
                "tx_from": "0x123...",
                "tx_hash": "0xabc...",
                "amount": 1.5,
                "price": 228.52,
                "value": 342.78,
                "ts": 1718600000
            }
        ],
        "page": 1,
        "size": 20
    },
    "traceId": "xxxx"
}

K 线

请求路径: /bgw-pro/market/v3/rwa/kline

请求方法: POST

最简 K 线，按结束时间向前翻页。按 chain+contract 查到数据源后分流：数据源为 ondo 走 ondo K 线；其它（含 xStocks）走链上 K 线。

请求参数:


{
    "chain": "sol",
    "contract": "XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB",
    "period": "5m",
    "size": 200,
    "end_time": 0
}

字段	类型	必填	说明
`chain`	string	是	链名称（如 `eth`/`sol`）
`contract`	string	是	合约地址
`period`	string	否	K 线周期，默认 `5m`
`size`	int	否	返回条数；不传按 period 推导
`end_time`	int64	否	秒级时间戳，向前翻页；不传返回最新

响应示例:


{
    "status": 0,
    "data": {
        "list": [
            {
                "ts": 1718600000,
                "open": 228.0,
                "high": 229.5,
                "low": 227.8,
                "close": 228.52,
                "volume": 12345.6,
                "amount": 54.0,
                "txn": 12
            }
        ]
    },
    "traceId": "xxxx"
}

volume、amount、txn 为链上 K 线字段；ondo 数据源不返回这三项。