/binance-tokenized-securities-info

name: binance-tokenized-securities-info
description: |
  Query Ondo tokenized US stock data on Binance Web3.
  Covers: supported stock token list, RWA metadata (company info, attestation reports),
  market and per-asset trading status (with corporate action codes for earnings, dividends, splits),
  real-time on-chain data (token price, holders, circulating supply, market cap),
  US stock fundamentals (P/E, dividend yield, 52-week range), and token K-Line/candlestick charts.

  Use this skill when users ask about:
  - Tokenized stock price, holders, or on-chain data for specific tickers
  - Whether a stock token is tradable, paused, or halted
  - Ondo RWA token list or which US stocks are available on-chain
  - Corporate actions affecting a token (dividends, stock splits, earnings halt)
  - Stock token K-Line or candlestick chart data
  - Comparing on-chain token price vs US stock price

  NOT for general crypto tokens (BTC, ETH, SOL, etc.) — use query-token-info for those.
metadata:
  author: binance-web3-team
  version: "1.1"

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

1. **List Supported Stocks**: Get all Ondo tokenized tickers with chain and contract info 2. **Company Research**: Get company metadata, CEO, industry, concept tags, and attestation reports 3. **Market Status Check**: Determine if the Ondo market is open, closed, or in pre/post-market session 4. **Corporate Action Detection**: Check if a specific asset is paused or limited due to earnings, dividends, stock splits, mergers, or maintenance 5. **Real-Time Data**: Get on-chain price, holder count, circulating supply, US stock P/E, dividend yield, 52-week range, and order limits 6. **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)