Company Share Float & Liquidity流通股与流动性

该接口返回指定上市公司的股本结构与自由流通盘（Share Float）快照，包含总股本（Outstanding Shares）、公开市场自由流通股数（Float Shares）及自由流通比例（Free Float %）。它是评估股票真实可交易筹码厚度、逼空风险与计算自由流通市值的关键接口。

GEThttps://quote-fmp.com/stable/shares-float?symbol=AAPL

数据更新周期

Daily

接口说明

  • 评估真实可交易筹码厚度与换手率基准：不少刚上市的次新股、家族控股企业或中概股虽然名义总市值庞大，但创始团队与战略股东锁定了绝大部分股份，实际在二级市场自由流通的筹码极少（低流通比例）。通过该接口核查自由流通股数与占比，可有效识别“大市值、小流通盘”导致的暴涨暴跌流动性陷阱。
  • 计算真实自由流通换手率与逼空潜力：在量化动量与资金博弈模型中，用每日成交量除以“自由流通股数”计算出的自由流通换手率，远比除以总股本更能反映筹码易手强度；同时，极小的自由流通盘也是高空头持仓标的爆发逼空行情的核心结构前提。
  • 现代宽基指数自由流通市值权重复刻：标普 500、MSCI 等主流市场指数均采用“自由流通市值”而非总市值计算成分股权重。投研团队利用该接口提供的自由流通比例系数乘以总市值，即可精确复刻机构指数基金的真实调仓权重。
  • 配套投研接口：Company Profile Data（公司概况） · Company Profile by CIK（按 CIK 查公司概况） · Income Statement（利润表） · Stock Screener（条件选股）

请求参数

1 个参数
参数类型要求示例说明
symbolstring必填AAPL证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS）

调用代码示例

Python 关键代码

示例向 /stable/shares-float 发起流通股与流动性请求（必填 symbol），并清洗 freeFloat（自由流通股本）、floatShares（流通股数）、outstandingShares（发行在外股本） 等核心列。

Python（核心参数与字段清洗逻辑）
resp = requests.get(
    "https://quote-fmp.com/stable/shares-float",
    params={"symbol": "AAPL", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 freeFloat（自由流通股本）
df["freeFloat"] = pd.to_numeric(df["freeFloat"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)

参数使用和避坑

2 组参数组合 · 2 条避坑

以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：

投研场景Query 参数组合示例返回数据特征与用途
按代码 AAPL 提取流通股与流动性截面symbol=AAPL对 /stable/shares-float 传入必填项 AAPL，读取 freeFloat、floatShares、outstandingShares（freeFloat=99.83000000136171）共 6 个字段。
港股腾讯（0700.HK）跨市场流通股与流动性拉取symbol=0700.HK传入 0700.HK 调用 /stable/shares-float，获取港股标的的 freeFloat、floatShares、outstandingShares（共 6 列）。
参数与空值防守流通股与流动性数据集：freeFloat 缺失值检测与默认值兜底

/stable/shares-float 返回的流通股与流动性数据集（必填 symbol）以 freeFloat（样本 99.83000000136171）为核心，入库或关联前建议先做缺失值检测。

落库主键与口径管理流通股与流动性历史表：(symbol, date) 排序键与 freeFloat 原始值

同步 /stable/shares-float 的 6 个字段入库时，依赖 (symbol, date) 实现幂等去重；核心数值 freeFloat（如 99.83000000136171）可直接用于量化回测计算。

返回数据

6 个字段

本接口示例响应共包含 6 个字段（数值型 3 个，文本/日期/布尔型 3 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。

字段类型示例值说明
symbolstring"AAPL"证券代码
datestring"2026-07-30 15:48:00"日期
freeFloatnumber99.83000000136171自由流通股本
floatSharesnumber14662387495流通股数
outstandingSharesnumber14687356000发行在外股本
sourcestring"https://www.sec.gov/Archives/e…"数据来源链接（SEC 原文）
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"date": "2026-07-30 15:48:00",
"freeFloat": 99.83000000136171,
"floatShares": 14662387495,
"outstandingShares": 14687356000,
"source": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000013/aapl-20260328.htm"
}
]

常见问题解答（FAQ）

2 个问题
流通股与流动性（/stable/shares-float）相比同模块的 全市场流通股数据，在查询维度与字段上差在哪？

流通股与流动性 走 /stable/shares-float 端点（必填 symbol），单条含 freeFloat、floatShares、outstandingShares 共 6 项字段；同模块的 All Shares Float（全市场流通股数据） 走 /stable/shares-float-all（无必填参数，5 项字段）。

针对 /stable/shares-float（流通股与流动性），工程脚本中如何避免漏数或无效轮询？

生产调度中通常在 /stable/shares-float 中指定 symbol（跨市场代码须保留后缀）；每次拉回 freeFloat（样本 99.83000000136171）后，按时间或代码水位线增量推进。

同模块相关接口对比

Shares Float

本接口路径 /stable/shares-float，必填参数 symbol。 同一模块「Shares Float」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。

接口路径核心差异与适用场景
全市场流通股数据All Shares Float/stable/shares-float-all按分页批量返回全市场所有上市公司的自由流通股数、总股本及自由流通比例全量数据表

Company（公司资料）全部接口目录 →

需要稳定访问 流通股与流动性 数据？注册即可获取专属 API Key，免费体验全部接口。
免费试用 1 个月