binance-tokenized-securities-info

by binance

Install this Skill

curl -fsSL -o binance-tokenized-securities-info.zip https://skill.seembox.com/api/v1/skills/binance-tokenized-securities-info/download && unzip binance-tokenized-securities-info.zip

Download binance-tokenized-securities-info.zip

SKILL.md About

---
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**:

**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.