binance-tokenized-securities-info

Name: binance-tokenized-securities-info
Author: binance

github.com/binance其他1.1k5.9k 次安装2 天前更新

代码仓库

关于 binance-tokenized-securities-info

Binance Tokenized Securities Info 是用于查询 Ethereum 和 BSC 上 Ondo 代币化股票的技能，提供代币及公司信息、交易状态、实时数据和 K 线数据。

主要功能

01列出代币化股票代码
02公司资料及证明报告
03市场与资产交易状态
04链上数据及股票基本面
05代币 K 线数据

适用场景

01查找支持的股票代币及合约信息
02研究公司资料和证明报告
03检查交易状态及公司行动限制
04获取代币价格和 K 线数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/binance/binance-skills-hub --skill binance-tokenized-securities-info

安装后在 Claude Code 中输入/binance-tokenized-securities-info确认已加载。

详细介绍

Binance 代币化证券信息 Skill

概述

API	功能	使用场景
Token Symbol List	列出所有代币化股票	浏览 Ondo 支持的股票代码，按类型筛选
RWA Meta	代币化股票元数据	公司信息、概念、证明报告
Market Status	整体市场开市/休市状态	查看 Ondo 市场当前是否正在交易
Asset Market Status	单项资产交易状态	检测公司行动（财报、股息、拆股、合并）
RWA Dynamic V2	完整实时数据	链上价格、持有人、美国股票基本面、订单限制
Token K-Line	K 线图	用于链上代币价格技术分析的 OHLC 数据

使用场景

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

核心概念：代币 ≠ 股票

每个代币代表底层股票的 multiplier 股，并不恰好代表 1 股。大多数代币的乘数接近 1.0（累计股息调整），但拆股代币的乘数可能为 5.0 或 10.0（例如，乘数 = 10.0 表示 1 个代币 = 10 股）。

referencePrice = tokenInfo.price ÷ sharesMultiplier

常见乘数类别请参见 Notes §6。

支持的链

Chain	chainId
Ethereum	1
BSC	56

API 1：Token Symbol List

方法：GET

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

示例：

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

响应：

{
  "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	股份乘数（参见上文关键概念，备注 §6）

API 2：RWA 元数据

方法：GET

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

示例：

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

响应：

{
  "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：市场状态

方法：GET

URL：

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

请求参数：无

请求头：Accept-Encoding: identity

示例：

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

响应：

{
  "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：资产市场状态

方法：GET

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

示例：

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

响应：

{
  "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 毫秒时间戳）

原因代码

reasonCode	描述
`TRADING`	正常交易
`MARKET_CLOSED`	市场已关闭（不在交易时段内）
`MARKET_PAUSED`	全市场暂停交易
`ASSET_PAUSED`	此特定资产已暂停（见下文“公司行动”）
`ASSET_LIMITED`	此特定资产受到交易限制（见下文“公司行动”）
`UNSUPPORTED`	不支持此资产
`MARKET_MAINTENANCE`	系统维护

公司行动（`ASSET_PAUSED` 或 `ASSET_LIMITED`）

资产暂停或受限时，reasonMsg 字段会指明具体的公司行动：

reasonCode	reasonMsg	Description
`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

方法：GET

URL：

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

请求参数：

Parameter	Type	Required	Description
chainId	string	是	链 ID
contractAddress	string	是	代币合约地址

请求头：Accept-Encoding: identity

示例：

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

响应：

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

响应字段

顶层（data）：

Field	Type	Description
symbol	string	代币代码（例如 `<TOKEN_SYMBOL_ON>`）
ticker	string	底层股票代码（例如 `<UNDERLYING_TICKER>`）
tokenInfo	object	链上代币数据
stockInfo	object	美国股票基本面数据
statusInfo	object	市场/资产交易状态（与 API 4 的结构相同）
limitInfo	object	订单限额信息

代币信息（data.tokenInfo）：

Field	Type	Description
price	string	链上代币价格（USD）— 按每个代币计算，而非每股（参见上文“关键概念”）
priceChange24h	string	24h 价格变动（USD）
priceChangePct24h	string	24h 价格变动（%）
totalHolders	string	链上持有者数量
sharesMultiplier	string	与 API 1 中的 `multiplier` 相同（参见上文“关键概念”、备注 §6）
volume24h	string	⚠️ 容易误导：这是美国股票的交易量（USD），不是链上 DEX 交易量
marketCap	string	链上市值（USD）= `circulatingSupply × price`
fdv	string	完全稀释估值（USD）
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	市盈率（TTM）
dividendYield	string	股息率（TTM，百分比数值：`0.27` 表示 0.27%）
priceToBook	string\|null	市净率
lastCashAmount	string\|null	最近一次每股现金股息金额（美元）

状态信息（data.statusInfo）：

架构与 API 4 响应相同。字段详情和原因代码请参阅资产市场状态。

限额信息（data.limitInfo）：

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

API 6：代币 K 线

方法：GET

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	否	-	起始时间戳（ms），根据蜡烛开盘时间计算
endTime	long	否	-	结束时间戳（ms），根据蜡烛开盘时间减去 1ms 计算

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

间隔参考：

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

请求头：Accept-Encoding: identity

示例：

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

响应：

{
  "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	蜡烛开盘时间戳（ms）
1	open	string	开盘价（USD）
2	high	string	最高价（USD）
3	low	string	最低价（USD）
4	close	string	收盘价（USD）
5	-	string	保留字段
6	closeTime	number	蜡烛收盘时间戳（ms）

响应字段：

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

User Agent 请求头

请在 User-Agent 请求头中包含以下字符串：binance-web3/1.1 (Skill)

说明

tokenInfo 中的 volume24h 容易引起误解：RWA Dynamic API 返回的 tokenInfo.volume24h 是美国股票每日交易量，单位为 USD，而不是链上 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 则因链而异。
multiplier / sharesMultiplier 对比价格时至关重要：每个代币代表标的股票的 multiplier 股，而不恰好是 1 股。该倍数初始为 1.0，之后会随着现金股息再投资而逐渐增加（累计股息调整）。有些代币还反映了股票拆分情况（例如，multiplier = 10.0 表示 1 个代币 = 10 股）。

公式：
```
referencePrice = tokenInfo.price ÷ sharesMultiplier
```
tokenInfo.price 和 stockInfo.price 来自不同来源（链上预言机与股票行情源），更新频率也不同，因此出现小幅溢价／折价（通常在 ±0.1% 以内）属于正常情况。

常见倍数类别：

倍数原因
恰好为 1.0 尚未派发股息，或刚刚上市
略高于 1.0 累计现金股息再投资（随时间增长）
5.0、10.0 代币结构中反映了股票拆分

随着股息累积，确切的倍数值会随时间变化。请务必在查询时从 API 读取，切勿硬编码。

支持 Markdown

登录后评论

基本信息

作者: binance
仓库: binance/binance-skills-hub
分类: 其他
安装次数: 5,889
GitHub Stars: 1,101

报告问题

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

倍数	原因
恰好为 1.0	尚未派发股息，或刚刚上市
略高于 1.0	累计现金股息再投资（随时间增长）
5.0、10.0	代币结构中反映了股票拆分

binance-tokenized-securities-info

关于 binance-tokenized-securities-info

主要功能

适用场景

安装

详细介绍

Binance 代币化证券信息 Skill

概述

推荐工作流

使用场景

核心概念：代币 ≠ 股票

支持的链

API 1：Token Symbol List

方法：GET

API 2：RWA 元数据

方法：GET

API 3：市场状态

方法：GET

API 4：资产市场状态

方法：GET

原因代码

公司行动（ASSET_PAUSED 或 ASSET_LIMITED）

API 5：RWA Dynamic V2

方法：GET

响应字段

API 6：代币 K 线

方法：GET

User Agent 请求头

说明

评论

公司行动（`ASSET_PAUSED` 或 `ASSET_LIMITED`）