> 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-plate-data.md).

# GET板块数据

行业板块列表、概念板块列表、板块成分股、行业介绍

### 接口说明

该系列接口提供板块维度的数据，包括行业板块列表、概念板块列表、板块成分股查询及行业AI分析介绍。

### 请求频率

跟其他接口请求频率使用同一个频率限制。具体每秒请求次数根据套餐决定。可以参考 [接口限制说明](https://docs.infoway.io/getting-started/api-limitation)

### 错误码说明

参考 [HTTP错误码说明](https://docs.infoway.io/getting-started/error-codes/http)

### 请求头

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

### 多语言支持 (I18n)

本页所有接口均支持多语言返回，追加 Query 参数 `lang` 即可控制返回内容中名称类字段的语言：

| 参数名    | 类型     | 必填 | 描述                           | 示例值     |
| ------ | ------ | -- | ---------------------------- | ------- |
| `lang` | String | 否  | `en` 返回英文（默认）；`zh-CN` 返回简体中文 | `zh-CN` |

两种语言的缓存相互独立、互不影响。传入其他值时按默认值 `en` 处理，不会报错。

**受 `lang` 影响的字段举例**

| 接口      | 字段                      | `lang=zh-CN`               | `lang=en`                                                      |
| ------- | ----------------------- | -------------------------- | -------------------------------------------------------------- |
| 行业板块列表  | `name`                  | 系统软件                       | Systems Software                                               |
| 概念板块列表  | `name`                  | 恒大系                        | Evergrande                                                     |
| 板块成分股   | `data.members[].name`   | 渣打集团                       | STANCHART                                                      |
| 行业介绍    | `intro`                 | 「多元化银行」包括提供广泛金融服务的大型银行机构…… | Large, geographically diverse banks with a national footprint… |
| 板块热力行情图 | `name`、`members[].name` | 多元化银行 / 汇丰控股               | Diversified Banks / HSBC HOLDINGS                              |

### 板块代码格式

| 类型   | 格式            | 示例                    |
| ---- | ------------- | --------------------- |
| 行业板块 | `IN{数字}.{市场}` | `IN20293.HK`（多元化银行）   |
| 概念板块 | `CP{数字}.{市场}` | `CP20027.HK`（生物医药B类股） |

### 支持的市场代码

`HK`（港股）、`US`（美股）、`CN`（A股）

***

### 行业板块列表

获取指定市场的所有行业板块。

**接口地址**

* 基本路径：`/common/v2/basic/plate/industry/{market}`
* 完整路径：`https://data.infoway.io/common/v2/basic/plate/industry/{market}`

**路径参数**

| 参数名      | 类型     | 必填 | 描述   | 示例值  |
| -------- | ------ | -- | ---- | ---- |
| `market` | String | 是  | 市场代码 | `HK` |

**Request param入参说明**

| 参数名     | 类型      | 必填 | 描述               | 示例值   |
| ------- | ------- | -- | ---------------- | ----- |
| `limit` | Integer | 否  | 返回数量，1-300，默认200 | `200` |

**返回示例**

```json
{
  "market": "HK",
  "count": 5,
  "data": [
    {
      "symbol": "IN20335.HK",
      "counter_id": "BK/HK/IN20335",
      "name": "安防与报警服务",
      "type": "industry",
      "chg": "0.0615",
      "last_done": "490.292",
      "change": "28.417",
      "rise": "1",
      "fall": "0",
      "total_amount": "3740100",
      "total_balance": "1835260892",
      "market_cap": "715513802"
    }
  ]
}
```

| 字段名             | 类型     | 描述          |
| --------------- | ------ | ----------- |
| `symbol`        | String | 板块代码        |
| `counter_id`    | String | 板块内部追溯ID    |
| `name`          | String | 板块名称        |
| `type`          | String | 板块分类        |
| `chg`           | String | 整体涨跌幅百分比    |
| `last_done`     | String | 当前板块点位（最新价） |
| `change`        | String | 变动点数        |
| `rise`          | String | 上涨家数        |
| `fall`          | String | 下跌家数        |
| `total_amount`  | String | **成交量（股数）** |
| `total_balance` | String | **成交额（金额）** |
| `market_cap`    | String | 板块总市值       |

***

### 概念板块列表

获取指定市场的概念/热门板块(暂不支持A股)。

**接口地址**

* 基本路径：`/common/v2/basic/plate/concept/{market}`
* 完整路径：`https://data.infoway.io/common/v2/basic/plate/concept/{market}`

**路径参数**

| 参数名      | 类型     | 必填 | 描述   | 示例值  |
| -------- | ------ | -- | ---- | ---- |
| `market` | String | 是  | 市场代码 | `HK` |

**Request param入参说明**

| 参数名     | 类型      | 必填 | 描述               | 示例值   |
| ------- | ------- | -- | ---------------- | ----- |
| `limit` | Integer | 否  | 返回数量，1-100，默认100 | `100` |

**返回示例**

```json
{
  "market": "HK",
  "count": 3,
  "data": [
    {
      "symbol": "CP20073.HK",
      "counter_id": "BK/HK/CP20073",
      "name": "体育用品",
      "type": "concept",
      "chg": "0.0813",
      "last_done": "1369.120",
      "change": "102.988",
      "rise": "2",
      "fall": "2",
      "total_amount": "54475526",
      "total_balance": "1765028354",
      "market_cap": "251731086514"
    }
  ]
}
```

| 字段名             | 类型     | 描述                           |
| --------------- | ------ | ---------------------------- |
| `symbol`        | String | 板块代码                         |
| `counter_id`    | String | 板块内部追溯ID                     |
| `name`          | String | 概念名称                         |
| `type`          | String | 板块分类，固定为 `concept`           |
| `chg`           | String | 整体涨跌幅，小数（`0.0813` 表示 +8.13%） |
| `last_done`     | String | 当前板块点位（最新价）                  |
| `change`        | String | 变动点数                         |
| `rise`          | String | 上涨家数                         |
| `fall`          | String | 下跌家数                         |
| `total_amount`  | String | **成交量（股数）**                  |
| `total_balance` | String | **成交额（金额）**                  |
| `market_cap`    | String | 板块总市值                        |

***

### 板块成分股

获取指定行业或概念板块下的所有成分股，支持分页。

**接口地址**

* 基本路径：`/common/v2/basic/plate/members/{plate_symbol}`
* 完整路径：`https://data.infoway.io/common/v2/basic/plate/members/{plate_symbol}`

**路径参数**

| 参数名            | 类型     | 必填 | 描述   | 示例值          |
| -------------- | ------ | -- | ---- | ------------ |
| `plate_symbol` | String | 是  | 板块代码 | `IN20293.HK` |

**Request param入参说明**

| 参数名      | 类型      | 必填 | 描述             | 示例值  |
| -------- | ------- | -- | -------------- | ---- |
| `offset` | Integer | 否  | 分页偏移，默认0       | `0`  |
| `limit`  | Integer | 否  | 每页数量，1-50，默认50 | `50` |

**返回示例**

```json
{
  "plate": "IN20293.HK",
  "counter_id": "BK/HK/IN20293",
  "data": {
    "total": 18,
    "offset": 0,
    "limit": 50,
    "members": [
      {"symbol": "1988.HK", "name": "民生银行", "last_done": "3.870", "chg": "0.0104"},
      {"symbol": "1658.HK", "name": "邮储银行", "last_done": "4.960", "chg": "0.0102"},
      {"symbol": "939.HK", "name": "建设银行", "last_done": "8.090", "chg": "0.0100"}
    ]
  }
}
```

| 字段名           | 类型      | 描述     |
| ------------- | ------- | ------ |
| `total`       | Integer | 成分股总数  |
| `offset`      | Integer | 当前偏移   |
| `limit`       | Integer | 当前每页数量 |
| `members`     | Array   | 成分股列表  |
| `> symbol`    | String  | 标的代码   |
| `> name`      | String  | 股票名称   |
| `> last_done` | String  | 最新价    |
| `> chg`       | String  | 涨跌幅    |

***

### 行业介绍

获取行业的AI分析报告。

**接口地址**

* 基本路径：`/common/v2/basic/plate/intro/{plate_symbol}`
* 完整路径：`https://data.infoway.io/common/v2/basic/plate/intro/{plate_symbol}`

**路径参数**

| 参数名            | 类型     | 必填 | 描述   | 示例值          |
| -------------- | ------ | -- | ---- | ------------ |
| `plate_symbol` | String | 是  | 板块代码 | `IN20293.HK` |

**返回示例**

```json
{
  "plate": "IN20293.HK",
  "intro": "「多元化银行」包括提供广泛金融服务的大型银行机构。这些银行通常在香港及国际上拥有广泛的分行网络..."
}
```

| 字段名     | 类型     | 描述          |
| ------- | ------ | ----------- |
| `plate` | String | 板块代码        |
| `intro` | String | AI生成的行业分析介绍 |

***

### 板块热力行情图 (Chart)

专用于前端渲染板块 Heatmap 或板块气泡分布图，拉平返回每个板块在该市场的权重占比 (Weight) 以及市值，可选下钻返回各板块的成分股。

**接口地址**

* 基本路径：`/common/v2/basic/plate/chart/{market}`
* 完整路径：`https://data.infoway.io/common/v2/basic/plate/chart/{market}`

**路径参数**

| 参数名      | 类型     | 必填 | 描述   | 示例值  |
| -------- | ------ | -- | ---- | ---- |
| `market` | String | 是  | 市场代码 | `CN` |

**Request param入参说明**

| 参数名            | 类型      | 必填 | 描述                                                  | 示例值    |
| -------------- | ------- | -- | --------------------------------------------------- | ------ |
| `limit`        | Integer | 否  | 返回板块数量，1-100，默认50                                   | `50`   |
| `with_members` | Boolean | 否  | 是否附带各板块的成分股（treemap 下钻用），默认 false                   | `true` |
| `member_limit` | Integer | 否  | 每个板块最多返回多少只成分股，1-50，默认10（仅当 `with_members=true` 生效） | `10`   |

**返回示例**

```json
{
  "market": "CN",
  "count": 1,
  "data": [
    {
      "symbol": "IN40239.SH",
      "counter_id": "BK/SH/IN40239",
      "name": "多元化银行",
      "last_done": "1567.65",
      "prev_close": "1569.49",
      "chg": "-0.0012",
      "market_cap": "14554669099556",
      "market_weight": "0.1136",
      "balance": "23587324006",
      "members": [
        {
          "symbol": "601398.SH",
          "name": "工商银行",
          "last_done": "7.90",
          "prev_close": "7.89",
          "chg": "0.0013",
          "market_cap": "2815609431003",
          "this_year_chg": "0.0179",
          "turnover_rate": "0.0011",
          "amplitude": "0.0127",
          "volume_rate": "0.53"
        }
      ]
    }
  ]
}
```

| 字段名             | 类型     | 描述                                    |
| --------------- | ------ | ------------------------------------- |
| `symbol`        | String | 板块代码                                  |
| `counter_id`    | String | 板块内部ID                                |
| `name`          | String | 板块名称                                  |
| `last_done`     | String | 板块指数最新值                               |
| `prev_close`    | String | 板块指数昨收                                |
| `chg`           | String | 板块整体涨跌幅，**小数比率**（`-0.0012` 表示 -0.12%） |
| `market_cap`    | String | 整体市值                                  |
| `market_weight` | String | 该板块市值占整个市场市值的权重系数（0-1之间）              |
| `balance`       | String | 板块成交额                                 |
| `members`       | Array  | 成分股列表，仅当 `with_members=true` 时返回      |

**members 数组字段：**

| 字段名             | 类型     | 描述                |
| --------------- | ------ | ----------------- |
| `symbol`        | String | 股票代码              |
| `name`          | String | 股票名称              |
| `last_done`     | String | 最新价               |
| `prev_close`    | String | 昨收价               |
| `chg`           | String | 涨跌幅，小数比率          |
| `market_cap`    | String | 市值（treemap 面积权重用） |
| `this_year_chg` | String | 年初至今涨跌幅           |
| `turnover_rate` | String | 换手率               |
| `amplitude`     | String | 振幅                |
| `volume_rate`   | String | 量比                |

> \[!TIP] 绘制 treemap 时，以 `members[].market_cap` 作为方块面积、`members[].chg` 作为方块颜色即可直接渲染热力图。