跳到主要内容

股票月线行情

数据集标识：equity.monthly_bars；证券对象标识示例：000001.SZ

股票按自然交易月聚合的行情。价格不复权，复权由读方用 ref.adjustment_factors 合成。成员资产类别：股票（stock）。

业务主键：asset_id、trading_date，每行取值唯一。

接口​

用途方法与路径
查询数据POST /v1/datasets/equity.monthly_bars/query
契约与当前发布GET /v1/datasets/equity.monthly_bars
准备批量快照POST /v1/datasets/equity.monthly_bars/preparations

请求参数​

可在请求体 where 中作为 field 使用的筛选参数，名称保持契约原名。

参数名类型必填说明
asset_idstring否筛选一个或多个标的标识（<场所码>:<代码>）。
security_codestring否筛选一个或多个证券代码。
adjustmentstring否复权口径；未指定时返回所有可用口径。
start_datedate否查询开始日期，包含该日。
end_datedate否查询结束日期，包含该日。

返回字段​

列名保持契约原名，可直接用于 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 的场所导出。
trading_date交易日期date否按交易场所本地时区确定的交易日。
open_price开盘价格decimal是该周期的开盘价格。
high_price最高价格decimal是该周期的最高价格。
low_price最低价格decimal是该周期的最低价格。
close_price收盘价格decimal是该周期的收盘价格。
previous_close_price前收盘价格decimal是上一交易周期的收盘价格。
price_change变动值decimal是收盘值相对前收盘值的变动。
price_return涨跌幅decimal是收盘值相对前收盘值的简单收益率，0.01 表示 1%。
volume成交数量decimal是标准基础数量单位下的成交数量。
turnover成交金额decimal是按价格币种表示的未缩放成交金额。
trade_count成交笔数integer是该周期内的成交笔数。
vwap成交量加权平均价decimal是该周期按成交数量加权的平均成交价格。
price_currency价格币种string否价格和成交金额使用的 ISO 4217 币种代码。
quantity_unit数量单位string否成交量使用的基础数量单位；股票为股，ETF 为份，统一代码 share。
is_final是否最终值boolean否数据观测时该周期是否已经结束；盘中及尚未结束的周、月周期为 false。

字段补充属性​

括号中是契约描述（GET /v1/datasets/{datasetId} 的 fields）里的键名。

字段名属性
open_price精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
high_price精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
low_price精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
close_price精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
previous_close_price精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
price_change精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
price_return精度（precision）：38；小数位数（scale）：18
volume精度（precision）：38；小数位数（scale）：18
turnover精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
vwap精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
quantity_unit枚举（allowedValues）：["share"]

请求示例​

向 https://api.<环境域名>/v1/datasets/equity.monthly_bars/query 发送 POST 请求（服务地址的替换方式见快速开始），请求头为 Authorization: Bearer <API_KEY> 与 Content-Type: application/json，请求体如下：

{
  "select": [
    "asset_id",
    "security_code",
    "trading_date",
    "open_price",
    "high_price",
    "low_price",
    "close_price",
    "previous_close_price",
    "price_change"
  ],
  "where": [
    {
      "field": "trading_date",
      "op": "gte",
      "value": "2026-01-01"
    },
    {
      "field": "trading_date",
      "op": "lte",
      "value": "2026-08-10"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

实际结果随数据更新而变化；data 为空数组表示请求范围内没有可返回的记录。

{
  "datasetId": "equity.monthly_bars",
  "fields": [
    "asset_id",
    "security_code",
    "trading_date",
    "open_price",
    "high_price",
    "low_price",
    "close_price",
    "previous_close_price",
    "price_change"
  ],
  "data": [],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}