> 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/rest-api/basic-info/get-symbol-list.md).

# GET查询产品列表

查询不同市场的产品列表，支持条件查询

### 接口说明

确认某市场是否包含所需产品。列表里的 `type` 与行情代码后缀不是同一套，见 标的代码约定。

### 请求频率

与其他 HTTP 接口共用[频率限制](/getting-started/api-limitation/http.md)。

### 错误码说明

见 [HTTP错误码](/getting-started/error-codes/http.md)。缺 `type` 时常见 HTTP 400：`Required parameter 'type' is not present.`

### 接口地址

* 基本路径：`/common/basic/symbols`
* 完整路径：`https://data.infoway.io/common/basic/symbols`

### 请求头

| 参数       | 类型     | 必填 | 描述         |
| -------- | ------ | -- | ---------- |
| `apiKey` | String | 是  | 套餐 API Key |

### Request param

| 参数名       | 类型     | 必填 | 描述                   | 示例值                |
| --------- | ------ | -- | -------------------- | ------------------ |
| `type`    | String | 是  | 标的类型，见下表。不能传市场码 `US` | `STOCK_US`         |
| `symbols` | String | 否  | 标的列表，逗号分隔            | `.DJI.US,.IXIC.US` |

#### type 说明

| 类型代码       | 描述                             |
| ---------- | ------------------------------ |
| `STOCK_US` | 美股                             |
| `STOCK_CN` | A 股（列表类型，行情代码仍用 `.SH` / `.SZ`） |
| `STOCK_HK` | 港股                             |
| `FUTURES`  | 期货                             |
| `FOREX`    | 外汇                             |
| `ENERGY`   | 能源                             |
| `METAL`    | 金属                             |
| `CRYPTO`   | 加密货币                           |
| `STOCK_IN` | 印股                             |
| `STOCK_JP` | 日股                             |
| `STOCK_KS` | 韩股                             |
| `STOCK_TW` | 台股                             |
| `INDICES`  | 指数                             |

### 返回示例

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "ed8a84d9-4575-4077-bc1c-31b17d0c8977",
  "data": [
    {
      "symbol": ".DJI.US",
      "name_cn": "道琼斯指数",
      "name_hk": "道瓊斯指數",
      "name_en": "Dow Jones Industrial Average",
      "name_local": "",
      "index": true
    }
  ]
}
```

| 字段名          | 类型      | 必填 | 描述                                        | 示例值          |
| ------------ | ------- | -- | ----------------------------------------- | ------------ |
| `symbol`     | String  | 是  | 标的代码                                      | `AAPL.US`    |
| `name_cn`    | String  | 否  | 中文名称                                      | `苹果`         |
| `name_hk`    | String  | 否  | 繁体名称                                      | `蘋果`         |
| `name_en`    | String  | 否  | 英文名称                                      | `Apple Inc.` |
| `name_local` | String  | 否  | 标的当地语言名称：JP=日文、KR=韩文、TW=繁体中文、IN=英文；其余类型为空 | `トヨタ自動車`     |
| `index`      | Boolean | 否  | 是否指数                                      | `true`       |

### 注意事项

* `type=STOCK_CN` 只表示「A 股列表」。查行情必须用 `600519.SH` / `000001.SZ`，不要写 `.CN`。
* 港股必须 5 位补零：`00700.HK`，`700.HK` 无效。
* 建议合理缓存列表，不必每次拉全量。