Ratios TTM BulkTTM 财务比率批量
该接口以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月(TTM)财务比率截面,涵盖盈利能力、偿债杠杆与运营周转等全套比率。
https://quote-fmp.com/stable/ratios-ttm-bulk数据更新周期
4-6 Hours
接口说明
- 盈利能力比率:毛利率、营业利润率、净利率等,帮助投资者评估公司经营的盈利水平,调用后可交付
grossProfitMarginTTM(毛利率(TTM))、ebitMarginTTM(EBIT利润率(TTM))与ebitdaMarginTTM(EBITDA利润率(TTM)) 等结构化信息,降低多资产投研系统的数据接入复杂度。 - 流动性比率:流动比率、速动比率、现金比率等关键指标,了解公司偿还短期负债的能力,通过单次 CSV 流式响应完成全市场数万标的截面同步。
- 运营效率比率:应收账款周转率、存货周转率、总资产周转率等,评估公司资产利用效率,自动化脚本中可与「TTM 关键指标批量」按序调取,一次性补齐该业务模块的核心字段。
- CSV 文本流格式:
/stable/ratios-ttm-bulk直接下发带表头的 CSV 文本流而非 JSON 数组,请使用pd.read_csv(io.StringIO(resp.text))流式读取。 - 上下游关联接口:Balance Sheet Statement Bulk(资产负债表批量数据) · Balance Sheet Statement Growth Bulk(资产负债表增长批量数据) · Financial Statement Symbols List(报表公司清单) · Income Statement(利润表)
调用代码示例
Python 关键代码/stable/ratios-ttm-bulk 单次流式返回全市场TTM 财务比率批量(含 grossProfitMarginTTM(毛利率(TTM))、ebitMarginTTM(EBIT 利润率(TTM))、ebitdaMarginTTM(EBITDA 利润率(TTM))),不可调 resp.json(),建议用 pd.read_csv 解析后存为 Parquet。
import io
resp = requests.get(
"https://quote-fmp.com/stable/ratios-ttm-bulk",
params={"apikey": FMP_KEY},
timeout=60,
)
resp.raise_for_status()
# TTM 财务比率批量返回 CSV 文本流,使用 io.StringIO 配合 pd.read_csv 解析
df = pd.read_csv(io.StringIO(resp.text))
df["grossProfitMarginTTM"] = pd.to_numeric(df["grossProfitMarginTTM"], errors="coerce")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量TTM 财务比率批量初始化本地主表 | GET /stable/ratios-ttm-bulk(免参数) | 该接口不吃 Query 条件:请求 /stable/ratios-ttm-bulk 直接下发全表 60 列,grossProfitMarginTTM、ebitMarginTTM、ebitdaMarginTTM 全在其中。 |
| 以 symbol 为唯一键覆盖写入,避免全表重复 | GET /stable/ratios-ttm-bulk → upsert on symbol | 落库键选 symbol(如 000001.SZ),60 列逐行覆盖;同模块没有带参接口,想补单条只能再拉一次全表。 |
| 落库后自检:symbol 唯一性与 grossProfitMarginTTM 空值率 | GET /stable/ratios-ttm-bulk → count(distinct symbol) / null_ratio(grossProfitMarginTTM) | 先用 symbol 去重计数校验 60 列是否完整落库,再看 grossProfitMarginTTM(样本 1.1622776732779352)的空值率;两者都正常才认为该批次可用。 |
TTM 财务比率批量接口 /stable/ratios-ttm-bulk 采用 CSV 流格式下发 grossProfitMarginTTM(1.1622776732779352)等全市场截面,请求时建议设 timeout=60 并以 io.StringIO 解析。
在 /stable/ratios-ttm-bulk 的返回结构中,grossProfitMarginTTM(1.1622776732779352)构成核心载荷,本地表以 (symbol) 保证幂等入库。
返回数据
60 个字段本接口示例响应共包含 60 个字段(数值型 0 个,文本/日期/布尔型 60 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
展开全部 60 个字段的完整说明
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "000001.SZ" | 证券代码 |
grossProfitMarginTTM | string | "1.1622776732779352" | 毛利率(TTM) |
ebitMarginTTM | string | "0.22525536322293388" | EBIT 利润率(TTM) |
ebitdaMarginTTM | string | "0.2018381390033096" | EBITDA 利润率(TTM) |
operatingProfitMarginTTM | string | "0.4658682349579752" | 营业利润率(TTM) |
pretaxProfitMarginTTM | string | "0.3160551441700993" | 税前利润率(TTM) |
continuousOperationsProfitMarginTTM | string | "0.25995857044215337" | 持续经营净利率(TTM) |
netProfitMarginTTM | string | "0.25995857044215337" | 净利率(TTM) |
bottomLineProfitMarginTTM | string | "0.25995857044215337" | 最终净利率(TTM) |
receivablesTurnoverTTM | string | "0" | 应收账款周转率(TTM) |
payablesTurnoverTTM | string | "0" | 应付账款周转率(TTM) |
inventoryTurnoverTTM | string | "0" | 存货周转率(TTM) |
fixedAssetTurnoverTTM | string | "13.114441842310695" | 固定资产周转率(TTM) |
assetTurnoverTTM | string | "0.029075827062555015" | 总资产周转率(TTM) |
currentRatioTTM | string | "0" | 流动比率(TTM) |
quickRatioTTM | string | "0" | 速动比率(TTM) |
solvencyRatioTTM | string | "0.008534174446189174" | 偿债能力比率(TTM) |
cashRatioTTM | string | "0" | 现金比率(TTM) |
priceToEarningsRatioTTM | string | "6.68445715569793" | 市盈率(P/E,TTM) |
priceToEarningsGrowthRatioTTM | string | "-3.6096068640768793" | 市盈率相对盈利增长比率(PEG,TTM) |
forwardPriceToEarningsGrowthRatioTTM | string | "2.4481492401413427" | 预期 PEG(TTM) |
priceToBookRatioTTM | string | "0.576796465809228" | 市净率(P/B,TTM) |
priceToSalesRatioTTM | string | "1.483200528584014" | 市销率(P/S,TTM) |
priceToFreeCashFlowRatioTTM | string | "1.518395607609901" | 市现率(P/FCF,TTM) |
priceToOperatingCashFlowRatioTTM | string | "1.7523793147342828" | 经营性市现率(P/OCF,TTM) |
debtToAssetsRatioTTM | string | "0" | 资产负债率(TTM) |
debtToEquityRatioTTM | string | "0" | 产权比率(负债/权益,TTM) |
debtToCapitalRatioTTM | string | "0" | 债务对资本比(TTM) |
longTermDebtToCapitalRatioTTM | string | "0" | 长期债务对资本比(TTM) |
financialLeverageRatioTTM | string | "11.416164801466868" | 财务杠杆率(TTM) |
workingCapitalTurnoverRatioTTM | string | "0.23544250931631752" | 营运资本周转率(TTM) |
operatingCashFlowRatioTTM | string | "0" | 经营现金流比率(TTM) |
operatingCashFlowSalesRatioTTM | string | "0.991612895545132" | 经营现金流对营收比(TTM) |
freeCashFlowOperatingCashFlowRatioTTM | string | "0.9850828696116743" | 自由现金流对经营现金流比(TTM) |
debtServiceCoverageRatioTTM | string | "0.24758322210087771" | 偿债覆盖率(TTM) |
interestCoverageRatioTTM | string | "0.7914088096104842" | 利息保障倍数(TTM) |
shortTermOperatingCashFlowCoverageRatioTTM | string | "0" | 短期经营现金流覆盖比率(TTM) |
operatingCashFlowCoverageRatioTTM | string | "0" | 经营现金流覆盖比率(TTM) |
capitalExpenditureCoverageRatioTTM | string | "67.03702213279678" | 资本开支覆盖比率(TTM) |
dividendPaidAndCapexCoverageRatioTTM | string | "6.192364879934577" | 股息与资本开支覆盖比率(TTM) |
dividendPayoutRatioTTM | string | "0.5590996519509067" | 股息支付率(TTM) |
dividendYieldTTM | string | "0.10335" | 股息率(TTM) |
enterpriseValueTTM | string | "-496959244000" | 企业价值(EV,TTM) |
revenuePerShareTTM | string | "7.389154370023568" | 每股营收(TTM) |
netIncomePerShareTTM | string | "1.9208740068077172" | 每股净利润(TTM) |
interestDebtPerShareTTM | string | "4.349676503966586" | 每股付息债务(TTM) |
cashPerShareTTM | string | "32.81790720767194" | 每股现金(TTM) |
bookValuePerShareTTM | string | "22.260885357516656" | 每股账面价值(TTM) |
tangibleBookValuePerShareTTM | string | "21.662613507347245" | 每股有形账面价值(TTM) |
shareholdersEquityPerShareTTM | string | "22.260885357516656" | 每股股东权益(TTM) |
operatingCashFlowPerShareTTM | string | "7.327180760489036" | 每股经营现金流(TTM) |
capexPerShareTTM | string | "0.10930051078304583" | 每股资本开支(TTM) |
freeCashFlowPerShareTTM | string | "7.21788024970599" | 每股自由现金流(TTM) |
netIncomePerEBTTTM | string | "0.8225101702576465" | 净利对税前利润比(TTM) |
ebtPerEbitTTM | string | "0.6784217520188082" | 税前利润对 EBIT 比(TTM) |
priceToFairValueTTM | string | "0.576796465809228" | 价格对公允价值比(TTM) |
debtToMarketCapTTM | string | "0" | 债务对市值比(TTM) |
effectiveTaxRateTTM | string | "0.17748982974235347" | 实际税率(TTM) |
enterpriseValueMultipleTTM | string | "-14.656106051669223" | 企业价值倍数(TTM) |
dividendPerShareTTM | string | "1.327" | 每股股息(TTM) |
查看响应数据示例(原始 JSON)
[
{
"symbol": "000001.SZ",
"grossProfitMarginTTM": "1.1622776732779352",
"ebitMarginTTM": "0.22525536322293388",
"ebitdaMarginTTM": "0.2018381390033096",
"operatingProfitMarginTTM": "0.4658682349579752",
"pretaxProfitMarginTTM": "0.3160551441700993",
"continuousOperationsProfitMarginTTM": "0.25995857044215337",
"netProfitMarginTTM": "0.25995857044215337",
"bottomLineProfitMarginTTM": "0.25995857044215337",
"receivablesTurnoverTTM": "0",
"payablesTurnoverTTM": "0",
"inventoryTurnoverTTM": "0",
"fixedAssetTurnoverTTM": "13.114441842310695",
"assetTurnoverTTM": "0.029075827062555015",
"currentRatioTTM": "0",
"quickRatioTTM": "0",
"solvencyRatioTTM": "0.008534174446189174",
"cashRatioTTM": "0",
"priceToEarningsRatioTTM": "6.68445715569793",
"priceToEarningsGrowthRatioTTM": "-3.6096068640768793",
"forwardPriceToEarningsGrowthRatioTTM": "2.4481492401413427",
"priceToBookRatioTTM": "0.576796465809228",
"priceToSalesRatioTTM": "1.483200528584014",
"priceToFreeCashFlowRatioTTM": "1.518395607609901",
"priceToOperatingCashFlowRatioTTM": "1.7523793147342828",
"debtToAssetsRatioTTM": "0",内容已截断,完整字段以实际返回为准。
计算口径对照:本接口涉及的全市场批量 TTM 财务比率各指标的计算公式对照,可查看 57 条财务比率计算公式大全 →
常见问题解答(FAQ)
2 个问题/stable/ratios-ttm-bulk 端点(TTM 财务比率批量)的参数设计与同模块的 公司概况批量 有什么区别?
工程上常将两者配合:用 TTM 财务比率批量(/stable/ratios-ttm-bulk,免业务参数)拉取 grossProfitMarginTTM 与 ebitMarginTTM 等 60 列,同时用 Company Profile Bulk(公司概况批量)补充 36 列关联信息。
使用 /stable/ratios-ttm-bulk 采集TTM 财务比率批量构建因子库,推荐的请求切片方式是什么?
采集 /stable/ratios-ttm-bulk 的核心技巧是每日定时调用一次 /stable/ratios-ttm-bulk 将全量字典同步至本地;这能确保 TTM 财务比率批量 的 grossProfitMarginTTM 与 ebitMarginTTM 连续完整且无截断遗漏。
同模块相关接口对比
Profile本接口路径 /stable/ratios-ttm-bulk,无必填参数。 同一模块「Profile」下共 11 个接口,下表列出其余 10 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公司概况批量Company Profile Bulk | /stable/profile-bulk | 以 CSV 流式分片形式一次性返回全市场上市公司的档案主表 |
| 评级批量Stock Rating Bulk | /stable/rating-bulk | 以单次 CSV 流式响应批量导出全市场股票的综合财务评级快照 |
| DCF 批量估值DCF Valuations Bulk | /stable/dcf-bulk | 一次请求即可返回多个代码的现金流折现(DCF)估值,含隐含价格变动空间与百分比差异 |
| 财务评分批量Financial Scores Bulk | /stable/scores-bulk | 以单次 CSV 流式响应批量返回全市场股票的 Piotroski F-Score与 Altman Z-Score截面 |
| 目标价汇总批量Price Target Summary Bulk | /stable/price-target-summary-bulk | 以单次 CSV 流式响应批量导出全市场覆盖股票的分析师目标价汇总截面 |
| ETF持股批量查询ETF Holder Bulk | /stable/etf-holder-bulk | ETF 持仓资产的详细清单,每项资产的持股数量、权重占比、市值 |
| 评级共识批量数据Upgrades Downgrades Consensus Bulk | /stable/upgrades-downgrades-consensus-bulk | 批量获取全部股票代码的分析师评级总览,一次请求即可拿到分析师上调评级、下调评级与共识推荐 |
| TTM 关键指标批量Key Metrics TTM Bulk | /stable/key-metrics-ttm-bulk | 以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月(TTM)关键财务指标截面 |
| 同业公司批量Stock Peers Bulk | /stable/peers-bulk | 以单次 CSV 流式响应批量导出全市场上市公司的同行业可比公司映射全表 |
| 批量财报超预期Earnings Surprises Bulk | /stable/earnings-surprises-bulk | 一次返回多家公司年度财报意外数据,实际 EPS 与预期 EPS 对比 |