跳到主要内容

标的别名与外部标识

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

标的的别名与外部标识，每行一个标识方案下的一个值在一段生效区间内属于一个标的：ISIN、场所内代码、展示别名，以及指数在各交易所行情中的发布代码（写成发布场所的 asset_id 形式，一个发布代码只映射到一个指数）。来源自有代码以 source:<来源名> 为方案名。

业务主键：asset_id、identifier_scheme、identifier_value、valid_from、available_at，每行取值唯一。

接口​

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

请求参数​

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

参数名类型必填说明
asset_idstring否标的标识，例如 XSHE:000001。
start_datedate否按生效日期筛选，查询开始日期，包含该日。
end_datedate否按生效日期筛选，查询结束日期，包含该日。

返回字段​

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

字段名中文名称类型可空说明
instrument_id终身标识string否BuQuant 在标的首次登记时分配的不透明标识，永不改变、永不复用；代码变更与转换场所不改变它，合并、分拆产生的新标的取新值。跨日期引用标的时按日期把 asset_id 解析为它。
asset_id标的标识string否与市场无关的标的标识，格式为 <场所码>:<代码>，场所码为运营 MIC 或 BQ 开头的登记码，例如 XSHE:000001。同一 asset_id 在任一时点只属于一个 instrument_id。
market市场string否场所所属市场码，由场所登记派生，例如 CN。
security_code展示别名string是场所登记的展示别名，例如 000001.SZ；无展示后缀的场所为空。
identifier_scheme标识方案string否标识方案登记值，如 isin、local_code、display_alias、dissemination_code，或 source:<来源名>。
identifier_value标识值string否该方案下的标识值；发布代码写成发布场所的 asset_id 形式，例如 XSHE:399300。
valid_from生效日期date否该段属性开始生效的日期，包含该日。
valid_to失效日期date是该段属性失效的日期，不含该日；为空表示仍有效。
available_at可知时间timestamp否该行信息首次公开可知的时刻（UTC），取依据公告或来源发布的时刻。同一段的更正以新行表达，按查询时点取不晚于它的最新一行。
is_retracted是否撤回boolean否该行是否撤回此前同键的行；撤回行自其可知时间起使该段在时点视图中消失。
basis_document依据文件string否该行的依据：交易所或编制方的公告、名单或来源端点。
evidence_sha256依据原件哈希string是依据原件内容的 sha256；尚未取得原件时为空。
verification_status核验状态string否verified 已有依据原件，unverified 尚未取得依据原件。

字段补充属性​

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

字段名属性
verification_status枚举（allowedValues）：["verified", "unverified"]

请求示例​

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

{
  "select": [
    "asset_id",
    "identifier_scheme",
    "identifier_value",
    "valid_from"
  ],
  "where": [
    {
      "field": "identifier_scheme",
      "op": "eq",
      "value": "dissemination_code"
    },
    {
      "field": "valid_from",
      "op": "gte",
      "value": "2005-04-08"
    },
    {
      "field": "valid_from",
      "op": "lte",
      "value": "2026-10-29"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "ref.instrument_identifiers",
  "fields": [
    "asset_id",
    "identifier_scheme",
    "identifier_value",
    "valid_from"
  ],
  "data": [],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}