复权因子
数据集标识:stock.adjustment_factors;证券对象标识示例:XSHE:000001
与分红、拆分和配股方法绑定的累计价格复权因子。每条因子自 effective_date 起生效,沿用到下一条生效日前一日;无成交日与停牌日按此规则仍取到最近一条不晚于该日的因子,不另造行。
接口
| 用途 | 方法与路径 |
|---|---|
| 查询数据 | POST /v1/datasets/stock.adjustment_factors/query |
| 契约与当前发布 | GET /v1/datasets/stock.adjustment_factors |
| 准备批量快照 | POST /v1/datasets/stock.adjustment_factors/preparations |
请求参数
可在请求体 where 中作为 field 使用的筛选参数,名称保持契约原名。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
asset_id | string | 否 | 筛选一个或多个标的标识(<场所码>:<代码>)。 |
security_code | string | 否 | 筛选一个或多个证券代码。 |
market | string | 否 | 市场代码;中文客户端默认 CN。 |
start_date | date | 否 | 查询开始日期,包含该日。 |
end_date | date | 否 | 查询结束日期,包含该日。 |
返回字段
列名保持契约原名,可直接用于 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 的场所导出。 |
effective_date | 生效日期 | date | 否 | 该累计复权因子生效的除权除息事件日期;每次除权除息对应一行,因子自该日起适用。 |
cumulative_adjustment_factor | 累计复权因子 | decimal | 否 | 截至该除权除息事件的累计价格复权乘数;每次除权除息对应一行。 |
reference_close_price | 参考收盘价 | decimal | 是 | 来源在计算或发布复权因子时同时给出的未复权收盘价。 |
methodology | 复权方法 | string | 否 | 因子的累计方向、基准和企业行动处理方法标识。取值为后复权累计口径:以最早可得交易日为基准锚点,此后按每次企业行动的比例连乘,得到截至该事件的累计乘数;前复权价格由未复权价格按 forward = raw × factor / factor_latest 换算,其中 factor_latest 为该证券最新事件的累计因子。 |
price_currency | 价格币种 | string | 否 | 参考收盘价使用的 ISO 4217 币种代码。 |
字段补充属性
括号中是契约描述(GET /v1/datasets/{datasetId} 的 fields)里的键名。
| 字段名 | 属性 |
|---|---|
cumulative_adjustment_factor | 精度(precision):38;小数位数(scale):18;单位(unit):ratio |
reference_close_price | 精度(precision):38;小数位数(scale):18;单位(unit):price_currency |
price_currency | 标准(standard):ISO 4217 |
请求示例
向 https://api.<环境域名>/v1/datasets/stock.adjustment_factors/query 发送 POST 请求(服务地址的替换方式见快速开始),请求头为 Authorization: Bearer <API_KEY> 与 Content-Type: application/json,请求体如下:
{
"select": [
"asset_id",
"security_code",
"effective_date",
"cumulative_adjustment_factor",
"reference_close_price",
"methodology",
"price_currency"
],
"where": [
{
"field": "asset_id",
"op": "eq",
"value": "XSHE:000001"
},
{
"field": "market",
"op": "eq",
"value": "CN"
},
{
"field": "effective_date",
"op": "gte",
"value": "2026-01-05"
},
{
"field": "effective_date",
"op": "lte",
"value": "2026-01-05"
}
],
"page": {
"limit": 1000,
"cursor": null
}
}
响应示例
实际结果随数据更新而变化;data 为空数组表示请求范围内没有可返回的记录。
{
"datasetId": "stock.adjustment_factors",
"fields": [
"asset_id",
"security_code",
"effective_date",
"cumulative_adjustment_factor",
"reference_close_price",
"methodology",
"price_currency"
],
"data": [
{
"asset_id": "XSHE:000001",
"cumulative_adjustment_factor": "134.579400000000000000",
"effective_date": "2026-01-05",
"methodology": "cumulative_back_adjustment",
"price_currency": "CNY",
"reference_close_price": null,
"security_code": "000001.SZ"
}
],
"page": {
"nextCursor": null,
"complete": true
}
}