# GET板块数据

### 接口说明

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

### 请求频率

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

### 错误码说明

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

### 请求头

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

### 板块代码格式

| 类型   | 格式            | 示例                    |
| ---- | ------------- | --------------------- |
| 行业板块 | `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",
      "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 | 成交额         |
| `market_cap`   | String | 板块总市值       |

***

#### 概念板块列表

获取指定市场的概念/热门板块。

**接口地址**

* 基本路径：`/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": "CP20027.HK",
      "counter_id": "BK/HK/CP20027",
      "name": "生物医药 B 类股",
      "chg": "0.0736",
      "intro": "符合港交所B类股上市规则的生物科技企业"
    }
  ]
}
```

| 字段名          | 类型     | 描述   |
| ------------ | ------ | ---- |
| `symbol`     | String | 板块代码 |
| `counter_id` | String | 板块ID |
| `name`       | String | 概念名称 |
| `chg`        | String | 涨跌幅  |
| `intro`      | 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 | 是  | 市场代码 | `HK` |

**Request param入参说明**

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

**返回示例**

```json
{
  "market": "HK",
  "count": 2,
  "data": [
    {
      "symbol": "IN20293.HK",
      "counter_id": "BK/HK/IN20293",
      "name": "多元化银行",
      "type": "industry",
      "chg": "0.0064",
      "market_cap": "14777418247285",
      "market_weight": "0.1952"
    }
  ]
}
```

| 字段名             | 类型     | 描述                       |
| --------------- | ------ | ------------------------ |
| `symbol`        | String | 板块代码                     |
| `name`          | String | 板块名称                     |
| `chg`           | String | 板块整体涨跌幅                  |
| `market_cap`    | String | 整体市值                     |
| `market_weight` | String | 该板块市值占整个市场市值的权重系数（0-1之间） |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.infoway.io/rest-api/basic-info/get-plate-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.