美股 风险类别 · REST 接口
风险类别。获取用于归类 SEC 申报文件风险因素的完整标准化层级分类体系,包含一级、二级、三级类别及详细说明与示例,便于跨公司与跨期做一致分析。
GET /stocks/taxonomies/vX/risk-factors上游时效说明
按需更新
上游历史范围
该接口不适用
适用场景
- 风险分类模型、类别级分析与看板、跨公司对比、量化风险评分、主题化监控。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
taxonomy | number | No | 分类法的版本标识(如 1.0、1.1)。取值必须为浮点数。 |
taxonomy.gt | number | No | 筛选大于该值。值必须为浮点数。 |
taxonomy.gte | number | No | 筛选大于或等于该值。值必须为浮点数。 |
taxonomy.lt | number | No | 筛选小于该值。值必须为浮点数。 |
taxonomy.lte | number | No | 筛选小于或等于该值。值必须为浮点数。 |
primary_category | string | No | 顶层风险类别。 |
primary_category.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
primary_category.gt | string | No | 筛选大于该值。 |
primary_category.gte | string | No | 筛选大于或等于该值。 |
primary_category.lt | string | No | 筛选小于该值。 |
primary_category.lte | string | No | 筛选小于或等于该值。 |
secondary_category | string | No | 中层风险类别。 |
secondary_category.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
secondary_category.gt | string | No | 筛选大于该值。 |
secondary_category.gte | string | No | 筛选大于或等于该值。 |
secondary_category.lt | string | No | 筛选小于该值。 |
secondary_category.lte | string | No | 筛选小于或等于该值。 |
tertiary_category | string | No | 最细粒度的风险分类。 |
tertiary_category.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
tertiary_category.gt | string | No | 筛选大于该值。 |
tertiary_category.gte | string | No | 筛选大于或等于该值。 |
tertiary_category.lt | string | No | 筛选小于该值。 |
tertiary_category.lte | string | No | 筛选小于或等于该值。 |
limit | integer | No | 限制返回结果的最大数量。未指定时默认为 200,允许的最大值为 1000。 |
sort | string | No | 逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 taxonomy,排序方向默认为 desc。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 本次请求的结果。 |
results[].description | string | 对该风险类别涵盖范围的详细说明,含具体示例与潜在影响。 |
results[].primary_category | string | 顶层风险类别。 |
results[].secondary_category | string | 中层风险类别。 |
results[].taxonomy | number | 分类法的版本标识(如 1.0、1.1)。 |
results[].tertiary_category | string | 最细粒度的风险分类。 |
status | enum: 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 文档 ↗