美股披露类别 · REST 接口

披露类别。获取用于归类 SEC 8-K 披露内容的完整标准化层级分类体系，包含一级、二级、三级类别及详细说明，是 8-K 披露接口背后的受控词表。

GET /stocks/taxonomies/vX/disclosures

上游时效说明

按需更新

上游历史范围

该接口不适用

适用场景

事件分类模型、类别级分析与看板、跨公司对比、构建分类感知的过滤器、公司披露的主题化监控。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`taxonomy`	string	No	定义该分类的分类体系版本（如 1.0）。
`taxonomy.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`taxonomy.gt`	string	No	筛选大于该值。
`taxonomy.gte`	string	No	筛选大于或等于该值。
`taxonomy.lt`	string	No	筛选小于该值。
`taxonomy.lte`	string	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`	string	定义该分类的分类体系版本（如 1.0）。
`results[].tertiary_category`	string	最细粒度的披露类别。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "request_id": "a1b2c3d4e5f6a7b8c9d0e1f2",
  "results": [
    {
      "description": "New CEO appointment with background, employment terms, and compensation.",
      "primary_category": "leadership_and_governance",
      "secondary_category": "executive_leadership",
      "taxonomy": "1.0",
      "tertiary_category": "ceo_appointment"
    },
    {
      "description": "Quarterly financial results including revenue, net income, EPS, and key operating metrics with management commentary.",
      "primary_category": "financial_results",
      "secondary_category": "earnings_and_performance",
      "taxonomy": "1.0",
      "tertiary_category": "quarterly_earnings"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

美股 披露类别 · REST 接口

适用场景

查询参数

响应字段

响应示例

美股披露类别 · REST 接口