skillpp 0.1.0

package/skills/binance-web3/binance-tokenized-securities-info/SKILL.md

@@ -0,0 +1,613 @@
+---
+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**:
+```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 (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**:
+```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`) |
+
+---
+
+## 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**:
+```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).
+
+---
+
+## 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**:
+```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)                                                |
+
+### 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**:
+```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
+}
+```
+
+### 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](#api-4-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**:
+```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              |
+
+---
+
+## User Agent Header
+
+Include `User-Agent` header with the following string: `binance-web3/1.1 (Skill)`
+
+## Notes
+
+1. **`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.
+
+2. **`dividendYield` is a percentage value, not a raw decimal**: A value of `0.27` means 0.27% dividend yield.
+
+3. **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`.
+
+4. **No API key required**: All endpoints are public APIs. No authentication needed.
+
+5. **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.
+
+6. **`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.