REST 接口 · 文档目录

美股 风险类别 · REST 接口

风险类别。获取用于归类 SEC 申报文件风险因素的完整标准化层级分类体系,包含一级、二级、三级类别及详细说明与示例,便于跨公司与跨期做一致分析。

GET /stocks/taxonomies/vX/risk-factors
上游时效说明

按需更新

上游历史范围

该接口不适用

适用场景

  • 风险分类模型、类别级分析与看板、跨公司对比、量化风险评分、主题化监控。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
taxonomynumberNo分类法的版本标识(如 1.0、1.1)。取值必须为浮点数。
taxonomy.gtnumberNo筛选大于该值。值必须为浮点数。
taxonomy.gtenumberNo筛选大于或等于该值。值必须为浮点数。
taxonomy.ltnumberNo筛选小于该值。值必须为浮点数。
taxonomy.ltenumberNo筛选小于或等于该值。值必须为浮点数。
primary_categorystringNo顶层风险类别。
primary_category.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
primary_category.gtstringNo筛选大于该值。
primary_category.gtestringNo筛选大于或等于该值。
primary_category.ltstringNo筛选小于该值。
primary_category.ltestringNo筛选小于或等于该值。
secondary_categorystringNo中层风险类别。
secondary_category.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
secondary_category.gtstringNo筛选大于该值。
secondary_category.gtestringNo筛选大于或等于该值。
secondary_category.ltstringNo筛选小于该值。
secondary_category.ltestringNo筛选小于或等于该值。
tertiary_categorystringNo最细粒度的风险分类。
tertiary_category.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
tertiary_category.gtstringNo筛选大于该值。
tertiary_category.gtestringNo筛选大于或等于该值。
tertiary_category.ltstringNo筛选小于该值。
tertiary_category.ltestringNo筛选小于或等于该值。
limitintegerNo限制返回结果的最大数量。未指定时默认为 200,允许的最大值为 1000。
sortstringNo逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 taxonomy,排序方向默认为 desc。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].descriptionstring对该风险类别涵盖范围的详细说明,含具体示例与潜在影响。
results[].primary_categorystring顶层风险类别。
results[].secondary_categorystring中层风险类别。
results[].taxonomynumber分类法的版本标识(如 1.0、1.1)。
results[].tertiary_categorystring最细粒度的风险分类。
statusenum: OK本次请求响应的状态。

响应示例

{
  "request_id": "daac836f71724420b66011d55d88b30b",
  "results": [
    {
      "description": "Risk from inadequate performance management systems, unclear accountability structures, or ineffective measurement and incentive systems that could affect employee performance, goal achievement, and organizational effectiveness.",
      "primary_category": "Governance & Stakeholder",
      "secondary_category": "Organizational & Management",
      "taxonomy": "1.0",
      "tertiary_category": "Performance management and accountability"
    },
    {
      "description": "Risk from requirements to monitor, document, and report on compliance with privacy and data protection regulations including risks from compliance program effectiveness, record-keeping requirements, and breach notification obligations.",
      "primary_category": "Regulatory & Compliance",
      "secondary_category": "Data & Privacy",
      "taxonomy": "1.0",
      "tertiary_category": "Compliance monitoring and reporting"
    }
  ],
  "status": "OK"
}

原文:Massive 文档 ↗