跳到主要内容

股票概况

数据集标识：stock.overview；证券对象标识示例：XSHE:000001

中国 A 股代码、名称、挂牌市场、上市日期、稳定身份和当前状态。

接口​

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

请求参数​

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

参数名类型必填说明
asset_idstring否筛选一个或多个标的标识（<场所码>:<代码>）。
security_codestring否筛选一个或多个证券代码。

返回字段​

列名保持契约原名，可直接用于 select、where 与结果行。

字段名中文名称类型可空说明
asset_id标的标识string否与市场无关的标的标识，格式为 <场所码>:<代码>，场所码为 ISO 10383 MIC，例如 XSHE:000001。
security_code证券代码string否展示别名：带市场后缀的证券代码，例如 000001.SZ；由 asset_id 换算，不作业务键。
local_code本地代码string否不含市场后缀的交易场所本地证券代码。
security_name证券简称string否当前业务有效区间内的证券简称。
full_name证券全称string是证券的正式全称。
english_name英文名称string是证券或发行人公开使用的英文名称。
pinyin_abbreviation拼音缩写string是中文证券名称的拼音缩写，仅在适用市场提供。
market市场string否证券所属市场代码；当前接口固定为 CN。
exchange交易所string是证券挂牌交易所代码。
market_segment市场板块string是主板、创业板、科创板或其他挂牌板块。
isinISINstring是ISO 6166 国际证券识别编码。
listing_status挂牌状态string是上市、暂停、退市或待挂牌等状态。
listing_date上市日期date是证券正式上市交易的业务日期。
delisting_date退市日期date是证券停止上市交易的业务日期。
round_lot_size每手数量decimal是该挂牌通常使用的最小整手交易数量。
industry_name行业名称string是按数据字典声明的默认分类方案归属的当前行业名称。
is_stST 标记boolean是是否处于中国市场风险警示状态；无权威来源时保持空值。
currency交易币种string否ISO 4217 交易币种代码
trading_currency交易币种string是ISO 4217 交易币种代码；来源仅能确认人民币时标准化为 CNY。
security_type证券类型string是证券类型

字段补充属性​

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

字段名属性
isin标准（standard）：ISO 6166
round_lot_size精度（precision）：38；小数位数（scale）：12；单位（unit）：quantity_unit
currency标准（standard）：ISO 4217

请求示例​

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

{
  "select": [
    "asset_id",
    "security_code",
    "local_code",
    "security_name",
    "full_name",
    "english_name",
    "pinyin_abbreviation",
    "market",
    "exchange"
  ],
  "where": [
    {
      "field": "asset_id",
      "op": "eq",
      "value": "XSHE:000001"
    },
    {
      "field": "market",
      "op": "eq",
      "value": "CN"
    },
    {
      "field": "listing_date",
      "op": "gte",
      "value": "1991-04-03"
    },
    {
      "field": "listing_date",
      "op": "lte",
      "value": "1991-04-03"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "stock.overview",
  "fields": [
    "asset_id",
    "security_code",
    "local_code",
    "security_name",
    "full_name",
    "english_name",
    "pinyin_abbreviation",
    "market",
    "exchange"
  ],
  "data": [
    {
      "asset_id": "XSHE:000001",
      "english_name": "Ping An Bank Co., Ltd.",
      "exchange": "SZ",
      "full_name": "平安银行股份有限公司",
      "local_code": "000001",
      "market": "CN",
      "pinyin_abbreviation": "PAYH",
      "security_code": "000001.SZ",
      "security_name": "平安银行"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}