# 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股）、`SG`（新加坡）

***

#### 行业板块列表

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

**接口地址**

* 基本路径：`/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之间） |