基本面
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
获取行业分组的层级子板块树,含各节点股票数量、日涨跌幅和年初至今涨跌幅。Counter ID 可从 industry_rank 返回结果中获取。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 必填 | 行业标识,如 `IN20245.HK`。 |
market | string | 必填 | 市场代码:`US` / `HK` / `CN` / `SG` |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
top | object | 可选 | 顶层行业信息, |
chain | object | 可选 | 行业层级树根节点, |
market | string | 可选 | 市场代码 |
symbol | string | 可选 | 板块标识(根节点上有值,子节点为空字符串)。 |
stock_num | integer | 可选 | 板块内股票数量 |
chg | string | 可选 | 当日涨跌幅(小数,可能为空字符串) |
ytd_chg | string | 可选 | 年初至今涨跌幅(小数,可能为空字符串) |
next | object[] | 可选 | 子板块列表,结构与当前节点相同(递归) |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"top": {
"name": "All Industries",
"market": "US"
},
"chain": {
"name": "Technology",
"symbol": "IN00258.US",
"stock_num": 542,
"chg": "0.0231",
"ytd_chg": "0.0875",
"next": [
{
"name": "Online Consumer Electronics Retail",
"symbol": "",
"stock_num": 4,
"chg": "0.0268",
"ytd_chg": "-0.1869",
"next": []
}
]
}
}
}错误码
参见错误码文档。