RWA Market Data

OpenAPI endpoints for on-chain RWA (e.g. tokenized US equities) market data. See Authentication for request signing.

Basics

Item	Value
Path prefix	`/bgw-pro/market/v3/rwa`
Content-Type	`application/json`
Response envelope	`{ "status": 0, "data": ..., "traceId": "..." }`

Endpoints

API	Method	Path	Description
Stock detail	`POST`	`/bgw-pro/market/v3/rwa/stockInfo`	Stock detail
Contract check	`POST`	`/bgw-pro/market/v3/rwa/checkContractIsRwa`	Whether chain+contract is an RWA token
Full list	`POST`	`/bgw-pro/market/v3/rwa/stockList`	All RWA tickers and tokens (incl. offline)
Transactions	`POST`	`/bgw-pro/market/v3/rwa/transactionList`	Minimal transaction list (paginated)
K-line	`POST`	`/bgw-pro/market/v3/rwa/kline`	Minimal K-line (paginate by end time)

Response envelope


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

`status`	Meaning
`0`	Success
`1`	Failure; `data` is an error message string

Error example:


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

Common enums

Data source data_source

Value	Description
`ondo`	Ondo
`xstocks`	xStocks
`reality`	Reality

Ticker status status

Value	Description
`online`	Active
`offline`	Delisted

Contract status status (inside contracts)

Value	Description
`online`	Active
`offline`	Delisted

Market status market_status

Value	Description
`open`	Market open
`close`	Market closed

Market status code market_status_code (ondo / reality; empty for xStocks)

Value	Description
`regular`	Regular session
`premarket`	Pre-market
`postmarket`	After-hours
`overnight`	Overnight
`paused`	Paused
`closed`	Closed

K-line period period

period	Meaning
`1s` / `5s` / `15s`	Seconds (xStocks only)
`1m` / `5m` / `15m` / `30m`	Minutes
`1h` / `2h` / `4h` / `6h` / `8h` / `12h`	Hours
`1d` / `3d` / `1w`	Days / week

Default period is 5m when omitted. ondo / reality do not support second-level periods (1s/5s/15s) or 12h.

Stock detail

Request Path: /bgw-pro/market/v3/rwa/stockInfo

Request Method: POST

Returns stock detail. Use either ticker or chain+contract.

Supports data sources ondo / xstocks / reality. Reality contracts return data_source=reality with market open/close status.

Request Parameters:


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

Field	Type	Required	Description
`ticker`	string	One of two	Stock symbol; normalized server-side
`chain`	string	One of two	Chain name (e.g. `eth`/`sol`/`morph`); send with `contract`
`contract`	string	One of two	Contract address
`has_offline`	bool	No	Include offline data; default `false`

Response Example:


{
    "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"
}

Check contract

Request Path: /bgw-pro/market/v3/rwa/checkContractIsRwa

Request Method: POST

Checks whether chain+contract is an RWA token and returns ticker and data source (includes offline mappings). data_source may be ondo / xstocks / reality.

Request Parameters:


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

Field	Type	Required	Description
`chain`	string	Yes	Chain name (Reality example: `morph`)
`contract`	string	Yes	Contract address

Response Example:


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

For Reality matches, data_source is "reality". When not matched, is_existed is false and stock_ticker / data_source are empty strings.

Full list

Request Path: /bgw-pro/market/v3/rwa/stockList

Request Method: POST

Returns all RWA tickers and contract mappings (including offline items via status). No request body fields. A single ticker may include contracts from multiple data sources (ondo / xstocks / reality).

Request Parameters:

{}

Response Example:


{
    "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"
                    },
                    {
                        "chain": "morph",
                        "contract": "0xabc...",
                        "symbol": "TSLAr",
                        "data_source": "reality",
                        "status": "online"
                    }
                ]
            }
        ]
    },
    "traceId": "xxxx"
}

Transaction list

Request Path: /bgw-pro/market/v3/rwa/transactionList

Request Method: POST

Minimal on-chain transaction list with pagination. Query by chain+contract; for Reality use the real chain (e.g. morph). Off-chain data is not supported.

Request Parameters:


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

Field	Type	Required	Description
`chain`	string	Yes	Chain name (use `morph` for Reality)
`contract`	string	Yes	Contract address
`side`	string	No	`buy`/`sell`; empty = all
`page`	int	No	Page number; default `1`
`size`	int	No	Page size; default `20`; capped at `100`

Response Example:


{
    "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-line

Request Path: /bgw-pro/market/v3/rwa/kline

Request Method: POST

Minimal K-line, paginated backward from end_time. Routes by data source:

Condition	Data path
`chain=rwa`	Off-chain (`contract` is ticker)
Data source `ondo` / `reality`	RWA service K-line for that source
Other (incl. xStocks)	On-chain K-line

Request Parameters:


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

Field	Type	Required	Description
`chain`	string	Yes	Chain name (e.g. `eth`/`sol`/`morph`); use `rwa` for off-chain
`contract`	string	Yes	Contract address; ticker when `chain=rwa`
`period`	string	No	K-line period; default `5m`
`size`	int	No	Bar count; default derived from period
`end_time`	int64	No	End timestamp (seconds); omit for latest

Response Example:


{
    "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, and txn may be present for on-chain and Reality K-lines; ondo usually omits them.

Reality example:


{
    "chain": "morph",
    "contract": "0xabc...",
    "period": "5m",
    "size": 200
}