股票行业归属
数据集标识:stock.industry_memberships;证券对象标识示例:XSHE:000001
股票在行业分类体系中的节点归属及其有效期。未指定 as_of 时返回当前有效记录;指定 as_of 时返回 effective_date <= as_of < end_date 的记录,end_date 为空表示持续有效。
接口
| 用途 | 方法与路径 |
|---|---|
| 查询数据 | POST /v1/datasets/stock.industry_memberships/query |
| 契约与当前发布 | GET /v1/datasets/stock.industry_memberships |
| 准备批量快照 | POST /v1/datasets/stock.industry_memberships/preparations |
请求参数
可在请求体 where 中作为 field 使用的筛选参数,名称保持契约原名。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
asset_id | string | 否 | 筛选一个或多个标的标识(<场所码>:<代码>)。 |
security_code | string | 否 | 筛选一个或多个证券代码。 |
as_of | datetime | 否 | 历史有效期查询日期;未提供时返回当前有效记录,提供时按有效区间筛选。 |
返回字段
列名保持契约原名,可直接用于 select、where 与结果行。
| 字段名 | 中文名称 | 类型 | 可空 | 说明 |
|---|---|---|---|---|
asset_id | 标的标识 | string | 否 | 与市场无关的标的标识,格式为 <场所码>:<代码>,场所码为 ISO 10383 MIC,例如 XSHE:000001。 |
security_code | 证券代码 | string | 否 | 展示别名:带市场后缀的证券代码,例如 000001.SZ;由 asset_id 换算,不作业务键。 |
market | 市场 | string | 否 | 标的挂牌场所所在的市场,ISO 3166-1 alpha-2 代码,例如 CN;由 asset_id 的场所导出。 |
classification_scheme | 分类体系 | string | 否 | GICS、ICB、申万或其他明确分类体系。 |
classification_version | 体系版本 | string | 是 | 分类体系的有效版本;来源无法证明版本时为空。 |
industry_code | 行业代码 | string | 否 | 分类体系内的行业代码。 |
industry_name | 行业名称 | string | 否 | 分类体系内的行业名称。 |
classification_level | 分类层级 | integer | 否 | 行业节点在分类体系内的层级。 |
effective_date | 生效日期 | date | 否 | 该行业归属开始生效的日期。 |
end_date | 结束日期 | date | 是 | 该行业归属结束生效的日期。 |
is_current | 是否当前归属 | boolean | 是 | 是否当前归属 |
请求示例
向 https://api.<环境域名>/v1/datasets/stock.industry_memberships/query 发送 POST 请求(服务地址的替换方式见快速开始),请求头为 Authorization: Bearer <API_KEY> 与 Content-Type: application/json,请求体如下:
{
"select": [
"asset_id",
"security_code",
"classification_scheme",
"classification_version",
"industry_code",
"industry_name",
"classification_level",
"effective_date",
"end_date"
],
"where": [
{
"field": "asset_id",
"op": "eq",
"value": "XSHE:000001"
},
{
"field": "market",
"op": "eq",
"value": "CN"
},
{
"field": "as_of",
"op": "eq",
"value": "2026-09-18T00:00:00Z"
}
],
"page": {
"limit": 1000,
"cursor": null
}
}
响应示例
实际结果随数据更新而变化;data 为空数组表示请求范围内没有可返回的记录。
{
"datasetId": "stock.industry_memberships",
"fields": [
"asset_id",
"security_code",
"classification_scheme",
"classification_version",
"industry_code",
"industry_name",
"classification_level",
"effective_date",
"end_date"
],
"data": [
{
"asset_id": "XSHE:000001",
"classification_level": 3,
"classification_scheme": "SW",
"classification_version": null,
"effective_date": "1991-04-03",
"end_date": null,
"industry_code": "857831.SI",
"industry_name": "股份制银行Ⅲ",
"security_code": "000001.SZ"
}
],
"page": {
"nextCursor": null,
"complete": true
}
}