Imported from jiayaoqijia/cryptoskill (skills/exchanges/binance-official-binance-tokenized-securities-info/SKILL.md). Install upstream with npx skills add jiayaoqijia/cryptoskill --skill binance-official-binance-tokenized-securities-info. Copyright stays with the author.

Binance Tokenized Securities Info Skill

Overview

API	Function	Use Case
Token Symbol List	List all tokenized stocks	Browse Ondo supported tickers, filter by type
RWA Meta	Tokenized stock metadata	Company info, concepts, attestation reports
Market Status	Overall market open/close	Check if Ondo market is currently trading
Asset Market Status	Per-asset trading status	Detect corporate actions (earnings, dividends, splits, mergers)
RWA Dynamic V2	Full real-time data	On-chain price, holders, US stock fundamentals, order limits
Token K-Line	Candlestick charts	OHLC data for on-chain token price technical analysis

Recommended Workflows

Scenario	Steps
Look up a stock's fundamentals and on-chain data	API 1 (get `chainId` + `contractAddress` by ticker) → API 5 (dynamic data)
Check if a stock token is tradable	API 3 (overall market status) → API 4 (per-asset status with reason code)
Research a tokenized stock	API 1 (find token) → API 2 (company metadata + attestation reports)
Get K-Line chart data	API 1 (find token) → API 6 (K-Line with interval)

Use Cases

List Supported Stocks: Get all Ondo tokenized tickers with chain and contract info
Company Research: Get company metadata, CEO, industry, concept tags, and attestation reports
Market Status Check: Determine if the Ondo market is open, closed, or in pre/post-market session
Corporate Action Detection: Check if a specific asset is paused or limited due to earnings, dividends, stock splits, mergers, or maintenance
Real-Time Data: Get on-chain price, holder count, circulating supply, US stock P/E, dividend yield, 52-week range, and order limits
Technical Analysis: Fetch token K-Line (candlestick) data with configurable intervals and time ranges

Key Concept: Token ≠ Share

Each token represents multiplier shares of the underlying stock, not exactly 1 share. Most tokens have a multiplier near 1.0 (cumulative dividend adjustment), but stock-split tokens can be 5.0 or 10.0 (e.g. multiplier = 10.0 means 1 token = 10 shares).

referencePrice = tokenInfo.price ÷ sharesMultiplier

See Notes §6 for common multiplier categories.

Supported Chains

Chain	chainId
Ethereum	1
BSC	56

API 1: Token Symbol List

Method: GET

URL:

https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rwa/stock/detail/list/ai

Request Parameters:

Parameter	Type	Required	Description
type	integer	No	Filter by platform: `1` = Ondo Finance (currently the only supported tokenized stock provider). Omit to return all platforms. Use `type=1` to retrieve only Ondo tokens.

Headers: Accept-Encoding: identity

Example:

curl 'https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rwa/stock/detail/list/ai' \
  -H 'Accept-Encoding: identity' \
  -H 'User-Agent: binance-web3/1.1 (Skill)'

Response:

{
  "code": "000000",
  "data": [
    {
      "chainId": "1",
      "contractAddress": "<CONTRACT_ADDRESS>",
      "symbol": "<TOKEN_SYMBOL_ON>",
      "ticker": "<UNDERLYING_TICKER>",
      "type": 1,
      "multiplier": "1.021663864228987186"
    },
    {
      "chainId": "56",
      "contractAddress": "<CONTRACT_ADDRESS>",
      "symbol": "<TOKEN_SYMBOL_ON>",
      "ticker": "<UNDERLYING_TICKER>",
      "type": 1,
      "multiplier": "1.010063782256545489"
    }
  ],
  "success": true
}

Response Fields (each item in data):

Field	Type	Description
chainId	string	Chain ID (`1` = Ethereum, `56` = BSC)
contractAddress	string	Token contract address
symbol	string	Token symbol (ticker + `on` suffix, e.g. `<TOKEN_SYMBOL_ON>`)
ticker	string	Underlying US stock ticker
type	integer	Platform type: `1` = Ondo
multiplier	string	Shares multiplier (see Key Concept above, Notes §6)

API 2: RWA Meta

Method: GET

URL:

https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rwa/meta/ai

Request Parameters:

Parameter	Type	Required	Description
chainId	string	Yes	Chain ID (e.g. `56` for BSC, `1` for Ethereum)
contractAddress	string	Yes	Token contract address

Headers: Accept-Encoding: identity

Example:

curl 'https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rwa/meta/ai?chainId=56&contractAddress=<CONTRACT_ADDRESS>' \
  -H 'Accept-Encoding: identity' \
  -H 'User-Agent: binance-web3/1.1 (Skill)'

Response:

{
  "code": "000000",
  "data": {
    "tokenId": "<TOKEN_ID>",
    "name": "<TOKEN_DISPLAY_NAME>",
    "symbol": "<TOKEN_SYMBOL_ON>",
    "ticker": "<UNDERLYING_TICKER>",
    "icon": "/images/web3-data/public/token/logos/<TOKEN_ID>.png",
    "dailyAttestationReports": "/images/web3-data/public/token/ondo/pdf/daily-<DATE>.pdf",
    "monthlyAttestationReports": "/images/web3-data/public/token/ondo/pdf/monthly-<MONTH>.pdf",
    "companyInfo": {
      "companyName": "<COMPANY_NAME_EN>",
      "companyNameZh": "<公司名称>",
      "homepageUrl": "",
      "description": "<COMPANY_DESCRIPTION_EN>",
      "descriptionZh": "<COMPANY_DESCRIPTION_CN>",
      "ceo": "<CEO_NAME>",
      "industry": "<INDUSTRY>",
      "industryKey": "<INDUSTRY_KEY>",
      "conceptsCn": ["概念标签A", "概念标签B", "概念标签C"],
      "conceptsEn": ["Concept Tag A", "Concept Tag B", "Concept Tag C"]
    },
    "decimals": 18
  },
  "success": true
}

Response Fields (data):

Field	Type	Description
tokenId	string	Token unique ID
name	string	Full token name (e.g. `<TOKEN_DISPLAY_NAME>`)
symbol	string	Token symbol (e.g. `<TOKEN_SYMBOL_ON>`)
ticker	string	Underlying stock ticker (e.g. `<UNDERLYING_TICKER>`)
icon	string	Icon image relative path. To get the full URL, prepend `https://bin.bnbstatic.com` (e.g. `https://bin.bnbstatic.com/images/web3-data/public/token/logos/<TOKEN_ID>.png`)
dailyAttestationReports	string	Daily attestation report relative path. Prepend `https://bin.bnbstatic.com` to get the full URL
monthlyAttestationReports	string	Monthly attestation report relative path. Prepend `https://bin.bnbstatic.com` to get the full URL
companyInfo	object	Company details (see below)
decimals	integer	Token decimals (typically `18`)

Company Info Fields (data.companyInfo):

Field	Type	Description
companyName	string	Company name in English
companyNameZh	string	Company name in Chinese
homepageUrl	string	Company homepage URL
description	string	Company description (English)
descriptionZh	string	Company description (Chinese)
ceo	string	CEO name
industry	string	Industry classification
industryKey	string	Industry i18n key
conceptsCn	string[]	Concept/theme tags in Chinese
conceptsEn	string[]	Concept/theme tags in English (e.g. `Concept Tag A`, `Concept Tag B`)

API 3: Market Status

Method: GET

URL:

https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rwa/market/status/ai

Request Parameters: None

Headers: Accept-Encoding: identity

Example:

curl 'https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rwa/market/status/ai' \
  -H 'Accept-Encoding: identity' \
  -H 'User-Agent: binance-web3/1.1 (Skill)'

Response:

{
  "code": "000000",
  "data": {
    "openState": false,
    "reasonCode": "MARKET_PAUSED",
    "reasonMsg": "Paused for session transition",
    "nextOpen": "2026-03-23T08:01:00Z",
    "nextClose": "2026-03-23T13:29:00Z",
    "nextOpenTime": 1774252860000,
    "nextCloseTime": 1774272540000
  },
  "success": true
}

Note: The sample above is captured with openState=false (market closed/paused), so nextOpen is earlier than nextClose.

Response Fields (data):

Field	Type	Description
openState	boolean	Whether the Ondo market is currently open for trading
reasonCode	string\|null	Reason code if market is not in normal trading state (see Reason Codes)
reasonMsg	string\|null	Human-readable reason message
nextOpen	string	Next market open time from current state (ISO 8601 UTC)
nextClose	string	Next market close time from current state (ISO 8601 UTC)
nextOpenTime	number	Next market open time from current state (Unix timestamp in ms)
nextCloseTime	number	Next market close time from current state (Unix timestamp in ms)

Interpretation: These fields are state-dependent. When openState=true, nextClose is expected to be earlier than nextOpen (market closes before the next open). When openState=false, nextOpen is expected to be earlier than nextClose (market opens before the next close).

API 4: Asset Market Status

Method: GET

URL:

https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rwa/asset/market/status/ai

Request Parameters:

Parameter	Type	Required	Description
chainId	string	Yes	Chain ID
contractAddress	string	Yes	Token contract address

Headers: Accept-Encoding: identity

Example:

curl 'https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/market/token/rwa/asset/market/status/ai?chainId=56&contractAddress=<CONTRACT_ADDRESS>' \
  -H 'Accept-Encoding: identity' \
  -H 'User-Agent: binance-web3/1.1 (Skill)'

Response:

{
  "code": "000000",
  "data": {
    "openState": false,
    "marketStatus": "closed",
    "reasonCode": "MARKET_CLOSED",
    "reasonMsg": null,
    "nextOpenTime": 1774252860000,
    "nextCloseTime": 1774272540000
  },
  "success": true
}

Response Fields (data):

Field	Type	Description
openState	boolean	Whether this specific asset is available for trading
marketStatus	string	Current session: `premarket`, `regular`, `postmarket`, `overnight`, `closed`, `pause`
reasonCode	string	Status reason code (see Reason Codes below)
reasonMsg	string\|null	Human-readable reason message (populated when paused/limited)
nextOpenTime	number	Next open time (Unix timestamp in ms)
nextCloseTime	number	Next close time (Unix timestamp in ms)

Reason Codes

reasonCode	Description
`TRADING`	Normal trading
`MARKET_CLOSED`	Market is closed (outside trading hours)
`MARKET_PAUSED`	Market-wide trading halt
`ASSET_PAUSED`	This specific asset is paused (see Corporate Actions below)
`ASSET_LIMITED`	This specific asset has trading restrictions (see Corporate Actions below)
`UNSUPPORTED`	Asset is not supported
`MARKET_MAINTENANCE`	System maintenance

Corporate Actions (when `ASSET_PAUSED` or `ASSET_LIMITED`)

When an asset is paused or limited, the reasonMsg field indicates the specific corporate action:

reasonCode	reasonMsg	Description
`ASSET_PAUSED`	`cash_dividend`	Cash dividend distribution
`ASSET_PAUSED`	`stock_dividend`	Stock dividend distribution
`ASSET_PAUSED`	`stock_split`	Stock split
`ASSET_PAUSED`	`merger`	Company merger
`ASSET_PAUSED`	`acquisition`	Company acquisition
`ASSET_PAUSED`	`spinoff`	Corporate spinoff
`ASSET_PAUSED`	`maintenance`	Asset-level maintenance
`ASSET_PAUSED`	`corporate action`	Other corporate action
`ASSET_LIMITED`	`earnings`	Earnings release — trading restricted but not fully paused

API 5: RWA Dynamic V2

Method: GET

URL:

https://www.binance.com/bapi/defi/v2/public/wallet-direct/buw/wallet/market/token/rwa/dynamic/ai

Request Parameters:

Parameter	Type	Required	Description
chainId	string	Yes	Chain ID
contractAddress	string	Yes	Token contract address

Headers: Accept-Encoding: identity

Example:

curl 'https://www.binance.com/bapi/defi/v2/public/wallet-direct/buw/wallet/market/token/rwa/dynamic/ai?chainId=56&contractAddress=<CONTRACT_ADDRESS>' \
  -H 'Accept-Encoding: identity' \
  -H 'User-Agent: binance-web3/1.1 (Skill)'

Response:

{
  "code": "000000",
  "data": {
    "symbol": "<TOKEN_SYMBOL_ON>",
    "ticker": "<UNDERLYING_TICKER>",
    "tokenInfo": {
      "price": "310.384196924055952519",
      "priceChange24h": "1.09518626611014170",
      "priceChangePct24h": "0.354098021064624509",
      "totalHolders": "1023",
      "sharesMultiplier": "1.001084338309087472",
      "volume24h": "8202859508.959922580629343392",
      "marketCap": "7116321.021286604958613714702150000306622972",
      "fdv": "7116321.021286604958613714702150000306622972",
      "circulatingSupply": "22927.459232171569002788",
      "maxSupply": "22927.459232171569002788"
    },
    "stockInfo": {
      "price": null,
      "priceHigh52w": "328.83",
      "priceLow52w": "140.53",
      "volume": "26429618",
      "averageVolume": "36255295",
      "sharesOutstanding": "5818000000",
      "marketCap": "1805815257704.157531755542",
      "turnoverRate": "0.4543",
      "amplitude": null,
      "priceToEarnings": "29.93",
      "dividendYield": "0.27",
      "priceToBook": null,
      "lastCashAmount": null
    },
    "statusInfo": {
      "openState": null,
      "marketStatus": null,
      "reasonCode": null,
      "reasonMsg": null,
      "nextOpenTime": null,
      "nextCloseTime": null
    },
    "limitInfo": {
      "maxAttestationCount": "1500",
      "maxActiveNotionalValue": "450000"
    }
  },
  "success": true
}

Response Fields

Top-level (data):

Field	Type	Description
symbol	string	Token symbol (e.g. `<TOKEN_SYMBOL_ON>`)
ticker	string	Underlying stock ticker (e.g. `<UNDERLYING_TICKER>`)
tokenInfo	object	On-chain token data
stockInfo	object	US stock fundamentals
statusInfo	object	Market/asset trading status (same schema as API 4)
limitInfo	object	Order limit information

Token Info (data.tokenInfo):

Field	Type	Description
price	string	On-chain token price (USD) — per-token, not per-share (see Key Concept above)
priceChange24h	string	24h price change (USD)
priceChangePct24h	string	24h price change (%)
totalHolders	string	Number of on-chain holders
sharesMultiplier	string	Same as `multiplier` in API 1 (see Key Concept above, Notes §6)
volume24h	string	⚠️ Misleading: This is the US stock trading volume in USD, NOT on-chain DEX volume
marketCap	string	On-chain market cap (USD) = `circulatingSupply × price`
fdv	string	Fully diluted valuation (USD)
circulatingSupply	string	Circulating supply (token units)
maxSupply	string	Maximum supply (token units)

Stock Info (data.stockInfo):

Field	Type	Description
price	string\|null	US stock price (USD). May be `null` outside trading hours
priceHigh52w	string	52-week high price (USD)
priceLow52w	string	52-week low price (USD)
volume	string	⚠️ US stock volume in shares (not USD). Multiply by `price` to get USD value
averageVolume	string	Average daily volume (shares)
sharesOutstanding	string	Total shares outstanding
marketCap	string	US stock total market cap (USD)
turnoverRate	string	Turnover rate (%)
amplitude	string\|null	Intraday amplitude (%)
priceToEarnings	string	P/E ratio (TTM)
dividendYield	string	Dividend yield (TTM, percentage value: `0.27` means 0.27%)
priceToBook	string\|null	P/B ratio
lastCashAmount	string\|null	Most recent cash dividend amount per share (USD)

Status Info (data.statusInfo):

Same schema as API 4 response. See Asset Market Status for field details and reason codes.

Limit Info (data.limitInfo):

Field	Type	Description
maxAttestationCount	string	Maximum attestation count for orders
maxActiveNotionalValue	string	Maximum active notional value for orders (USD)

API 6: Token K-Line

Method: GET

URL:

https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/kline/ai

Request Parameters:

Parameter	Type	Required	Default	Description
chainId	string	Yes	-	Chain ID (e.g. `56` for BSC, `1` for Ethereum)
contractAddress	string	Yes	-	Token contract address
interval	string	Yes	-	K-Line interval (see Interval Reference)
limit	integer	No	300	Number of candles to return (max 300)
startTime	long	No	-	Start timestamp (ms), based on candle open time
endTime	long	No	-	End timestamp (ms), based on candle open time minus 1ms

Note on startTime / endTime: Both reference the candle's open time. If omitted, returns the latest candles. When both are provided, endTime should be the target candle's open time minus 1ms.

Interval Reference:

Interval	Description
1m	1 minute
5m	5 minutes
15m	15 minutes
1h	1 hour
4h	4 hours
12h	12 hours
1d	1 day

Headers: Accept-Encoding: identity

Example:

curl 'https://www.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/dex/market/token/kline/ai?chainId=56&contractAddress=<CONTRACT_ADDRESS>&interval=1d&limit=5' \
  -H 'Accept-Encoding: identity' \
  -H 'User-Agent: binance-web3/1.1 (Skill)'

Response:

{
  "code": "000000",
  "data": {
    "klineInfos": [
      [1773619200000, "302.935406291919976543", "306.960384694362870577", "302.25959298411397863", "305.249336787737745037", "0", 1773705599999],
      [1773705600000, "305.644964527245747627", "311.890874865402466994", "303.302517784917770672", "311.028506552196415779", "0", 1773791999999]
    ],
    "decimals": 5
  },
  "success": true
}

Candle Array Format (each element in data.klineInfos[]):

Index	Field	Type	Description
0	openTime	number	Candle open timestamp (ms)
1	open	string	Open price (USD)
2	high	string	High price (USD)
3	low	string	Low price (USD)
4	close	string	Close price (USD)
5	-	string	Reserved field
6	closeTime	number	Candle close timestamp (ms)

Response Fields:

Field	Type	Description
klineInfos	array	Array of candle arrays (see format above)
decimals	integer	Price decimal precision hint

User Agent Header

Include User-Agent header with the following string: binance-web3/1.1 (Skill)

Notes

volume24h in tokenInfo is misleading: tokenInfo.volume24h from the RWA Dynamic API returns the US stock daily trading volume in USD, not the on-chain DEX trading volume. For actual on-chain buy/sell volume, use the Binance on-chain dynamic API (/market/token/dynamic/info) with volume24hBuy + volume24hSell fields instead.
dividendYield is a percentage value, not a raw decimal: A value of 0.27 means 0.27% dividend yield.
Icon and report URLs are relative paths — prepend domain to use: The API returns relative paths for icon, dailyAttestationReports, and monthlyAttestationReports (e.g. /images/web3-data/public/token/logos/...). To construct the full URL, prepend https://bin.bnbstatic.com. Example: /images/web3-data/public/token/logos/<TOKEN_ID>.png → https://bin.bnbstatic.com/images/web3-data/public/token/logos/<TOKEN_ID>.png.
No API key required: All endpoints are public APIs. No authentication needed.
Multi-chain deployments: Each supported stock may be deployed on multiple chains (e.g. both Ethereum and BSC). stockInfo and tokenInfo.price are identical across chains. tokenInfo.totalHolders is aggregated cross-chain. tokenInfo.circulatingSupply and tokenInfo.marketCap are chain-specific.

multiplier / sharesMultiplier — critical for price comparison: Each token represents multiplier shares of the underlying stock, not exactly 1 share. The multiplier starts at 1.0 and increases over time as cash dividends are reinvested (cumulative dividend adjustment). Some tokens also reflect stock splits (e.g. multiplier = 10.0 means 1 token = 10 shares).

Formula:

referencePrice = tokenInfo.price ÷ sharesMultiplier

tokenInfo.price and stockInfo.price come from different sources (on-chain oracle vs stock feed) and update at different frequencies, so a small premium/discount (typically within ±0.1%) is normal.

Common multiplier categories:

Multiplier	Cause
Exactly 1.0	No dividends paid yet, or newly listed
Slightly above 1.0	Cumulative cash dividend reinvestment (grows over time)
5.0, 10.0	Stock split reflected in token structure

The exact multiplier value changes over time as dividends accumulate. Always read it from the API at query time — never hardcode.

binance-tokenized-securities-info

About

Binance Tokenized Securities Info Skill

Overview

Recommended Workflows

Use Cases

Key Concept: Token ≠ Share

Supported Chains

API 1: Token Symbol List

Method: GET

API 2: RWA Meta

Method: GET

API 3: Market Status

Method: GET

API 4: Asset Market Status

Method: GET

Reason Codes

Corporate Actions (when `ASSET_PAUSED` or `ASSET_LIMITED`)

API 5: RWA Dynamic V2

Method: GET

Response Fields

API 6: Token K-Line

Method: GET

User Agent Header

Notes

Use it

Manifest

Reviews

About

Binance Tokenized Securities Info Skill

Overview

Recommended Workflows

Use Cases

Key Concept: Token ≠ Share

Supported Chains

API 1: Token Symbol List

Method: GET

API 2: RWA Meta

Method: GET

API 3: Market Status

Method: GET

API 4: Asset Market Status

Method: GET

Reason Codes

Corporate Actions (when ASSET_PAUSED or ASSET_LIMITED)

API 5: RWA Dynamic V2

Method: GET

Response Fields

API 6: Token K-Line

Method: GET

User Agent Header

Notes

Use it

Manifest

Reviews

Corporate Actions (when `ASSET_PAUSED` or `ASSET_LIMITED`)