跳到主要内容

上市公司资料

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

股票发行公司的法定身份、注册信息、联系方式和主营业务。

接口​

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

请求参数​

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

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

返回字段​

列名保持契约原名，可直接用于 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 的场所导出。
company_name公司名称string否发行公司的法定全称。
unified_social_credit_code统一社会信用代码string是中国境内企业的统一社会信用代码；不适用市场为空。
legal_representative_name法定代表人string是公司登记的法定代表人姓名。
general_manager_name总经理string是公司当前总经理姓名。
board_secretary_name董事会秘书string是公司当前董事会秘书姓名。
registered_capital注册资本decimal是未缩放的法定注册资本金额。
registered_capital_currency注册资本币种string是注册资本使用的 ISO 4217 币种代码。
incorporation_date成立日期date是公司依法成立或注册的日期。
province省级地区string是公司登记或主要办公地所在省级行政区。
city城市string是公司登记或主要办公地所在城市。
company_description公司简介string是公司公开披露的业务和历史简介。
website公司网站string是公司官方网站地址。
email电子邮箱string是公司公开联系邮箱。
office_address办公地址string是公司公开办公地址。
employee_count员工人数integer是最近一次披露的员工人数。
primary_business主营业务string是公司主要业务和产品。
business_scope经营范围string是公司登记或披露的经营范围。

字段补充属性​

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

字段名属性
registered_capital精度（precision）：38；小数位数（scale）：2；单位（unit）：registered_capital_currency
registered_capital_currency标准（standard）：ISO 4217
employee_count单位（unit）：人

请求示例​

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

{
  "select": [
    "asset_id",
    "security_code",
    "company_name",
    "unified_social_credit_code",
    "legal_representative_name",
    "general_manager_name",
    "board_secretary_name",
    "registered_capital",
    "registered_capital_currency"
  ],
  "where": [
    {
      "field": "market",
      "op": "eq",
      "value": "CN"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "stock.company_profiles",
  "fields": [
    "asset_id",
    "security_code",
    "company_name",
    "unified_social_credit_code",
    "legal_representative_name",
    "general_manager_name",
    "board_secretary_name",
    "registered_capital",
    "registered_capital_currency"
  ],
  "data": [],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}