binance-tokenized-securities-info

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Binance Tokenized Securities Info Skill

Binance代币化证券信息技能

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

API	功能	适用场景
代币符号列表	列出所有代币化股票	浏览Ondo支持的代码，按类型筛选
RWA元数据	代币化股票元数据	公司信息、概念、证明报告
市场状态	整体市场开盘/收盘状态	检查Ondo市场当前是否可交易
单资产市场状态	单资产交易状态	识别公司行为（收益、分红、拆股、合并）
RWA动态数据V2	完整实时数据	链上价格、持有者数量、美股基本面数据、订单限制
代币K线	蜡烛图	链上代币价格技术分析的OHLC数据

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)

场景	步骤
查询股票基本面数据及链上数据	API 1（通过代码获取 `chainId` + `contractAddress` ）→ API 5（动态数据）
检查股票代币是否可交易	API 3（整体市场状态）→ API 4（带原因码的单资产状态）
调研代币化股票	API 1（查找代币）→ API 2（公司元数据 + 证明报告）
获取K线图数据	API 1（查找代币）→ API 6（带时间间隔的K线数据）

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

列出支持的股票：获取所有Ondo代币化代码及链和合约信息
公司调研：获取公司元数据、CEO、行业、概念标签及证明报告
市场状态检查：判断Ondo市场当前是开盘、收盘还是处于盘前/盘后时段
公司行为识别：检查特定资产是否因收益发布、分红、拆股、合并或维护而暂停或受限
实时数据获取：获取链上价格、持有者数量、流通供应量、美股市盈率P/E、股息率、52周价格区间及订单限制
技术分析：获取可配置时间间隔和时间范围的代币K线（蜡烛图）数据

Supported Chains

支持的链

Chain	chainId
Ethereum	1
BSC	56

链	chainId
Ethereum	1
BSC	56

API 1: Token Symbol List

API 1：代币符号列表

Method: GET

请求方法：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:

bash

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:

json

{
  "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 (cumulative dividend adjustment factor)

URL:

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

请求参数:

参数	类型	是否必填	描述
type	integer	否	按平台筛选： `1` = Ondo Finance（目前唯一支持的代币化股票提供商）。省略则返回所有平台。请使用 `type=1` 仅获取Ondo代币。

请求头:

Accept-Encoding: identity

示例:

bash

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)'

响应:

json

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

响应字段（

data

中的每个项）:

字段	类型	描述
chainId	string	链ID（ `1` = Ethereum， `56` = BSC）
contractAddress	string	代币合约地址
symbol	string	代币符号（代码 + `on` 后缀，例如 `<TOKEN_SYMBOL_ON>` ）
ticker	string	标的美股代码
type	integer	平台类型： `1` = Ondo
multiplier	string	股份乘数（累计分红调整因子）

API 2: RWA Meta

API 2：RWA元数据

Method: GET

请求方法：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:

bash

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:

json

{
  "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` )

URL:

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

请求参数:

参数	类型	是否必填	描述
chainId	string	是	链ID（例如BSC为 `56` ，Ethereum为 `1` ）
contractAddress	string	是	代币合约地址

请求头:

Accept-Encoding: identity

示例:

bash

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)'

响应:

json

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

响应字段（

data

）:

字段	类型	描述
tokenId	string	代币唯一ID
name	string	代币全名（例如 `<TOKEN_DISPLAY_NAME>` ）
symbol	string	代币符号（例如 `<TOKEN_SYMBOL_ON>` ）
ticker	string	标的股票代码（例如 `<UNDERLYING_TICKER>` ）
icon	string	图标相对路径。要获取完整URL，请添加前缀 `https://bin.bnbstatic.com` （例如 `https://bin.bnbstatic.com/images/web3-data/public/token/logos/<TOKEN_ID>.png` ）
dailyAttestationReports	string	每日证明报告相对路径。添加前缀 `https://bin.bnbstatic.com` 获取完整URL
monthlyAttestationReports	string	每月证明报告相对路径。添加前缀 `https://bin.bnbstatic.com` 获取完整URL
companyInfo	object	公司详情（见下文）
decimals	integer	代币小数位数（通常为 `18` ）

公司信息字段（

data.companyInfo

）:

字段	类型	描述
companyName	string	公司英文名称
companyNameZh	string	公司中文名称
homepageUrl	string	公司官网URL
description	string	公司英文描述
descriptionZh	string	公司中文描述
ceo	string	CEO名称
industry	string	行业分类
industryKey	string	行业国际化键
conceptsCn	string[]	中文概念/主题标签
conceptsEn	string[]	英文概念/主题标签（例如 `Concept Tag A` , `Concept Tag B` ）

API 3: Market Status

API 3：市场状态

Method: GET

请求方法：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:

bash

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:

json

{
  "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).

URL:

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

请求参数：无

请求头:

Accept-Encoding: identity

示例:

bash

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)'

响应:

json

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

注意：上述示例是在
openState=false
（市场关闭/暂停）时捕获的，因此
nextOpen
早于
nextClose
。

响应字段（

data

）:

字段	类型	描述
openState	boolean	Ondo市场当前是否可交易
reasonCode	string\|null	若市场非正常交易状态的原因码（见原因码列表）
reasonMsg	string\|null	人类可读的原因信息
nextOpen	string	当前状态下的下一次市场开盘时间（ISO 8601 UTC格式）
nextClose	string	当前状态下的下一次市场收盘时间（ISO 8601 UTC格式）
nextOpenTime	number	当前状态下的下一次市场开盘时间（毫秒级Unix时间戳）
nextCloseTime	number	当前状态下的下一次市场收盘时间（毫秒级Unix时间戳）

说明：这些字段与当前状态相关。当
openState=true
时，
nextClose
应早于
nextOpen
（市场在下次开盘前收盘）。当
openState=false
时，
nextOpen
应早于
nextClose
（市场在下次收盘前开盘）。

API 4: Asset Market Status

API 4：单资产市场状态

Method: GET

请求方法：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:

bash

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:

json

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

URL:

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

请求参数:

参数	类型	是否必填	描述
chainId	string	是	链ID
contractAddress	string	是	代币合约地址

请求头:

Accept-Encoding: identity

示例:

bash

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)'

响应:

json

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

响应字段（

data

）:

字段	类型	描述
openState	boolean	该特定资产是否可交易
marketStatus	string	当前时段： `premarket` （盘前）、 `regular` （常规交易时段）、 `postmarket` （盘后）、 `overnight` （隔夜）、 `closed` （收盘）、 `pause` （暂停）
reasonCode	string	状态原因码（见下文原因码）
reasonMsg	string\|null	人类可读的原因信息（当资产暂停/受限时填充）
nextOpenTime	number	下一次开盘时间（毫秒级Unix时间戳）
nextCloseTime	number	下一次收盘时间（毫秒级Unix时间戳）

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

reasonCode	描述
`TRADING`	正常交易
`MARKET_CLOSED`	市场关闭（非交易时段）
`MARKET_PAUSED`	全市场交易暂停
`ASSET_PAUSED`	该特定资产暂停（见下文公司行为）
`ASSET_LIMITED`	该特定资产交易受限（见下文公司行为）
`UNSUPPORTED`	资产不受支持
`MARKET_MAINTENANCE`	系统维护

Corporate Actions (when

ASSET_PAUSED

ASSET_LIMITED

)

公司行为（当

ASSET_PAUSED

或

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

当资产暂停或受限时，

reasonMsg

字段会指明具体的公司行为：

reasonCode	reasonMsg	描述
`ASSET_PAUSED`	`cash_dividend`	现金分红发放
`ASSET_PAUSED`	`stock_dividend`	股票分红发放
`ASSET_PAUSED`	`stock_split`	股票拆股
`ASSET_PAUSED`	`merger`	公司合并
`ASSET_PAUSED`	`acquisition`	公司收购
`ASSET_PAUSED`	`spinoff`	公司分拆
`ASSET_PAUSED`	`maintenance`	资产级维护
`ASSET_PAUSED`	`corporate action`	其他公司行为
`ASSET_LIMITED`	`earnings`	收益发布 — 交易受限但未完全暂停

API 5: RWA Dynamic V2

API 5：RWA动态数据V2

Method: GET

请求方法：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:

bash

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:

json

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

URL:

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

请求参数:

参数	类型	是否必填	描述
chainId	string	是	链ID
contractAddress	string	是	代币合约地址

请求头:

Accept-Encoding: identity

示例:

bash

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)'

响应:

json

{
  "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)
priceChange24h	string	24h price change (USD)
priceChangePct24h	string	24h price change (%)
totalHolders	string	Number of on-chain holders
sharesMultiplier	string	Shares multiplier (cumulative dividend adjustment factor)
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)

顶层字段（

data

）:

字段	类型	描述
symbol	string	代币符号（例如 `<TOKEN_SYMBOL_ON>` ）
ticker	string	标的股票代码（例如 `<UNDERLYING_TICKER>` ）
tokenInfo	object	链上代币数据
stockInfo	object	美股基本面数据
statusInfo	object	市场/资产交易状态（与API 4 schema相同）
limitInfo	object	订单限制信息

代币信息（

data.tokenInfo

）:

字段	类型	描述
price	string	链上代币价格（美元）
priceChange24h	string	24小时价格变动（美元）
priceChangePct24h	string	24小时价格变动百分比（%）
totalHolders	string	链上持有者数量
sharesMultiplier	string	股份乘数（累计分红调整因子）
volume24h	string	⚠️ 注意：此数据有误导性：该字段是美股的美元交易额，而非链上DEX交易量
marketCap	string	链上市值（美元） = `circulatingSupply × price`
fdv	string	完全稀释估值（美元）
circulatingSupply	string	流通供应量（代币单位）
maxSupply	string	最大供应量（代币单位）

股票信息（

data.stockInfo

）:

字段	类型	描述
price	string\|null	美股价格（美元）。非交易时段可能为 `null`
priceHigh52w	string	52周最高价（美元）
priceLow52w	string	52周最低价（美元）
volume	string	⚠️ 美股交易量（单位为股，非美元）。乘以 `price` 可得到美元价值
averageVolume	string	日均交易量（股）
sharesOutstanding	string	总流通股数
marketCap	string	美股总市值（美元）
turnoverRate	string	换手率（%）
amplitude	string\|null	日内振幅（%）
priceToEarnings	string	市盈率P/E（滚动12个月）
dividendYield	string	股息率（滚动12个月，百分比值： `0.27` 代表0.27%）
priceToBook	string\|null	市净率P/B
lastCashAmount	string\|null	最近一次每股现金分红金额（美元）

状态信息（

data.statusInfo

）:

与API 4响应schema相同。详见单资产市场状态的字段说明和原因码。

限制信息（

data.limitInfo

）:

字段	类型	描述
maxAttestationCount	string	订单最大证明次数
maxActiveNotionalValue	string	订单最大活跃名义价值（美元）

API 6: Token K-Line

API 6：代币K线

Method: GET

请求方法：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:

bash

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:

json

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

URL:

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

请求参数:

参数	类型	是否必填	默认值	描述
chainId	string	是	-	链ID（例如BSC为 `56` ，Ethereum为 `1` ）
contractAddress	string	是	-	代币合约地址
interval	string	是	-	K线时间间隔（见时间间隔参考）
limit	integer	否	300	返回的蜡烛数量（最大300）
startTime	long	否	-	起始时间戳（毫秒），基于蜡烛开盘时间
endTime	long	否	-	结束时间戳（毫秒），基于蜡烛开盘时间减1ms

注意
startTime
/
endTime
：两者均参考蜡烛的开盘时间。若省略，则返回最新的蜡烛数据。若同时提供，
endTime
应为目标蜡烛开盘时间减1ms。

时间间隔参考:

时间间隔	描述
1m	1分钟
5m	5分钟
15m	15分钟
1h	1小时
4h	4小时
12h	12小时
1d	1天

请求头:

Accept-Encoding: identity

示例:

bash

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)'

响应:

json

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

蜡烛数组格式（

data.klineInfos[]

中的每个元素）:

索引	字段	类型	描述
0	openTime	number	蜡烛开盘时间戳（毫秒）
1	open	string	开盘价（美元）
2	high	string	最高价（美元）
3	low	string	最低价（美元）
4	close	string	收盘价（美元）
5	-	string	预留字段
6	closeTime	number	蜡烛收盘时间戳（毫秒）

响应字段:

字段	类型	描述
klineInfos	array	蜡烛数组（格式见上文）
decimals	integer	价格小数精度提示

User Agent Header

User-Agent请求头

Include

User-Agent

header with the following string:

binance-web3/1.1 (Skill)

请在请求头中包含

User-Agent

，值为：

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.

tokenInfo
中的
volume24h
有误导性：RWA动态API返回的
```
tokenInfo.volume24h
```
是美股的每日美元交易额，而非链上DEX的交易量。若要获取实际的链上买卖交易量，请使用Binance链上动态API（
```
/market/token/dynamic/info
```
）中的
```
volume24hBuy
```
+
```
volume24hSell
```
字段。
dividendYield
是百分比值，而非原始小数：值为
```
0.27
```
代表股息率为0.27%。

图标和报告URL是相对路径——需添加域名前缀使用：API返回的

icon

、

dailyAttestationReports

和

monthlyAttestationReports

是相对路径（例如

/images/web3-data/public/token/logos/...

）。要构建完整URL，请添加前缀

https://bin.bnbstatic.com

。示例：

/images/web3-data/public/token/logos/<TOKEN_ID>.png

→

https://bin.bnbstatic.com/images/web3-data/public/token/logos/<TOKEN_ID>.png

。

无需API密钥：所有端点均为公开API，无需身份验证。
多链部署：每个支持的股票可能部署在多条链上（例如同时在Ethereum和BSC上）。
```
stockInfo
```
和
```
tokenInfo.price
```
在各链上相同。
```
tokenInfo.totalHolders
```
是跨链聚合数据。
```
tokenInfo.circulatingSupply
```
和
```
tokenInfo.marketCap
```
是链特定数据。

binance-tokenized-securities-info

Original

Translation

Binance Tokenized Securities Info Skill

Binance代币化证券信息技能

Overview

概述

Recommended Workflows

推荐工作流

Use Cases

适用场景

Supported Chains

支持的链

API 1: Token Symbol List

API 1：代币符号列表

Method: GET

请求方法：GET

API 2: RWA Meta

API 2：RWA元数据

Method: GET

请求方法：GET

API 3: Market Status

API 3：市场状态

Method: GET

请求方法：GET

API 4: Asset Market Status

API 4：单资产市场状态

Method: GET

请求方法：GET

Reason Codes

原因码

Corporate Actions (when ASSET_PAUSED or ASSET_LIMITED)

公司行为（当ASSET_PAUSED或ASSET_LIMITED时）

API 5: RWA Dynamic V2

API 5：RWA动态数据V2

Method: GET

请求方法：GET

Response Fields

响应字段

API 6: Token K-Line

API 6：代币K线

Method: GET

请求方法：GET

User Agent Header

User-Agent请求头

Notes

注意事项

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

公司行为（当
`ASSET_PAUSED`
或
`ASSET_LIMITED`
时）