美股流通股本 · REST 接口

流通股本（自由流通）。获取指定股票的最新自由流通股本。自由流通股本指扣除战略或长期持有者持股后、可公开交易的股份数量。创始人、高管与董事、员工、控股股东、关联公司、私募股权与风险投资、主权财富基金、政府机构、员工持股计划、信托、限售或锁定股份，以及持股 5% 以上的股东所持股份不计入可流通供给；养老金、共同基金、ETF、无董事会席位的对冲基金、存托银行等广泛分散的投资者持股一般计入。自由流通股本是衡量流动性、波动率、市场冲击与股权结构的关键输入；数据基于公开披露与持股信息，可能存在报告时滞。

GET /stocks/vX/float

上游时效说明

按需更新

上游历史范围

该接口不适用

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

查询参数

参数	类型	必填	说明
`ticker`	string	No	该股票的主代码。
`ticker.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`ticker.gt`	string	No	筛选大于该值。
`ticker.gte`	string	No	筛选大于或等于该值。
`ticker.lt`	string	No	筛选小于该值。
`ticker.lte`	string	No	筛选小于或等于该值。
`free_float_percent`	number	No	流通在外股份中可公开交易股份所占的百分比，四舍五入到小数点后 2 位。取值必须为浮点数。
`free_float_percent.gt`	number	No	筛选大于该值。值必须为浮点数。
`free_float_percent.gte`	number	No	筛选大于或等于该值。值必须为浮点数。
`free_float_percent.lt`	number	No	筛选小于该值。值必须为浮点数。
`free_float_percent.lte`	number	No	筛选小于或等于该值。值必须为浮点数。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 5000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 ticker，排序方向默认为 asc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].effective_date`	string	自由流通股本测算的生效日期。
`results[].free_float`	integer	可在市场上自由交易的股份数量。自由流通股本指公司已发行股份中可在市场自由交易的部分，不包括任何被视为战略性、控制性或长期持有的股份。具体剔除内部人、董事、创始人、持股 5% 以上股东、交叉持股、政府持股（养老金除外）、受限或锁定股份、员工计划，以及任何对董事会有影响力的实体，仅保留真正可供公开交易的股份。
`results[].free_float_percent`	number	流通在外股份中可公开交易股份所占的百分比，四舍五入到小数点后 2 位。
`results[].ticker`	string	该股票的主代码。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "request_id": 1,
  "results": [
    {
      "effective_date": "2025-11-01",
      "free_float": 15000000000,
      "free_float_percent": 98.5,
      "ticker": "AAPL"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

美股 流通股本 · REST 接口

查询参数

响应字段

响应示例

美股流通股本 · REST 接口