> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/getting-started/biao-di-dai-ma-yue-ding.md).

# 标的代码约定

股票行情 REST / WebSocket 使用带交易所后缀的代码；数字币及其他品种使用下表约定。基础信息列表的 `type`（如 `STOCK_CN`）只用于筛选市场，**不能**当作行情后缀。

查列表用 [GET查询产品列表](/rest-api/basic-info/get-symbol-list.md)。查行情见 [行情地址说明](/getting-started/api-endpoints.md)。品种不存在见 [HTTP错误码](/getting-started/error-codes/http.md) `508`。

### 股票与指数

| 市场    | 后缀 / 形式        | 正确示例                | 错误示例                  |
| ----- | -------------- | ------------------- | --------------------- |
| 美股    | `.US`          | `AAPL.US`、`.DJI.US` | `AAPL`                |
| 港股    | `.HK`，代码补足 5 位 | `00700.HK`          | `700.HK`              |
| A 股上海 | `.SH`          | `600519.SH`         | `600519.CN`           |
| A 股深圳 | `.SZ`          | `000001.SZ`         | `000001.CN`           |
| 日股    | `.JP`          | `7203.JP`           |                       |
| 韩股    | `.KS`          | `005930.KS`         | 缺少 `.KS`（WS 可能 `520`） |
| 印股    | `.IN`          |                     |                       |
| 台股    | `.TW`          | `2330.TW`           | 缺少 `.TW`（WS 可能 `520`） |

`600519.CN`、`000001.CN` 会返回 `All product not exists`（REST `ret=508`，生产上也可能落到 `ret=500`）。

### 其他品种

| 市场            | 形式             | 示例                |
| ------------- | -------------- | ----------------- |
| 加密货币现货        | 交易对            | `BTCUSDT`         |
| 加密货币永续合约      | 以 `.P` 结尾的产品代码 | `BTCUSDT.P`       |
| 外汇            | 货币对            | `USDJPY`、`EURUSD` |
| 贵金属 / 能源 / 期货 | 品种代码           | `XAUUSD`          |

始终使用产品列表返回的 `symbol` 原值；不要自行插入下划线。数字币使用 HTTP `/crypto/...` 和 WebSocket `business=crypto`。外汇、商品、期货及相关指数使用 HTTP `/common/...` 和 WebSocket `business=common`（不是 `tv`）。

`crypto` 通道的永续合约成交数据可通过 `withMarkPrice` 开启附加字段，见 [HTTP 成交](/rest-api/http-endpoints/get-trade.md) 和 [WebSocket 成交订阅](/websocket-api/subscribe-and-unsubscribe/trade-subscribe.md)。

### 基础信息 `type`

`/common/basic/symbols` 的 `type` 必须用产品类型，不能传市场码 `US`：

`STOCK_US` `STOCK_CN` `STOCK_HK` `STOCK_JP` `STOCK_KS` `STOCK_IN` `STOCK_TW`\
`CRYPTO` `FOREX` `FUTURES` `ENERGY` `METAL` `INDICES`

传 `type=US` 或缺 `type` 会得到 HTTP 400。