按公司名称查询印度股票的季度业绩、年度业绩、资产负债表、现金流、财务比率和持股历史
查看 印度股票交易所 API 的全部接口 →返回单家印度上市公司的历史财务统计数据,按公司名称查询。stock_name 为必填(例如 TCS,接口文档中还出现了 TATAMOTORS)。stats 为可选参数,用于指定要返回的统计分组;其文档默认值是以逗号分隔的 quarter_results、yoy_results、balancesheet、cashflow、ratios、shareholding_pattern_quarterly 和 shareholding_pattern_yearly,而接口文档中的示例请求只使用单个值 quarter_results。该接口没有做过实测调用,因此下面所有响应细节都来自未经验证的来源示例:一个以会计科目为键的 JSON 对象(Sales、Expenses、Operating Profit、OPM %、Other Income、Interest、Depreciation、Profit before tax、Tax %、Net Profit,以及以卢比计的 EPS),每个科目把 Jun 2021、Sep 2021、Mar 2024 等期间标签映射到数值。该示例中每个科目包含 13 个季度期间,与 quarter_results 分组相似;期间标签按字母顺序而非时间顺序排列,除 EPS 的 Rs 标签和百分比标签外,没有说明其他货币单位。其余六个分组的响应结构、多个分组在同一响应中如何组合,以及公司名称无法识别时的行为均未经验证。这些数据仅供参考,不是经审计的备案文件,也不构成投资建议。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/indian-stock-exchange-api/historical-stats API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/historical-stats?key=<API_KEY>&stats=quarter_results%2Cyoy_results%2Cbalancesheet%2Ccashflow%2Cratios%2Cshareholding_pattern_quarterly%2Cshareholding_pattern_yearly&stock_name=TCS'
查询结果
使用场景
- 财报季看板:对自选股清单中的每家公司,把各季度业绩与去年同期做对比。
- 营收增长筛选器:循环处理一批公司名称,按最近几个季度 Sales 的变化幅度排序。
- 大模型上下文构建:把整理好的季度业绩表交给 LLM,而不是让它去读抓取的网页。
- 股东结构趋势图:在持股分组有数据时,用它画出大股东与机构持股比例的变化。
- 表格或 n8n 自动化:每次公司发布业绩后,刷新一张该公司的利润率与 EPS 对照表。
常见问题
历史统计接口会返回什么?
返回所查公司的财务统计数据,是一个 JSON 对象。在提供的来源示例(并非实测)中,每个键是一个会计科目,例如 Sales、Expenses、Operating Profit、OPM %、Net Profit 或以卢比计的 EPS,每个值把 Jun 2021 这样的期间标签映射到一个数值。该示例包含 13 个季度,与 quarter_results 分组相似。
stats 参数可以传什么值?
传以逗号分隔的分组名称:quarter_results、yoy_results、balancesheet、cashflow、ratios、shareholding_pattern_quarterly 和 shareholding_pattern_yearly。文档默认值会请求全部七类,而文档中的示例请求只传了 quarter_results。
stats 是必填还是可选?
书面的接口说明把 stats 写成必填,但实际声明的参数是可选的,默认值为全部七个分组。始终必填的只有 stock_name。显式传入 stats 可以让响应内容更可预期。
这个接口做过实测调用吗?
没有对历史统计接口做过实测调用。响应说明来自来源示例,因此 yoy_results、balancesheet、cashflow、ratios 以及持股分组的结构,还有多分组响应的形态,都没有经过验证。
各期间列是按什么顺序返回的?
在来源示例中,期间标签按字母顺序出现(Dec 2021、Dec 2022、Dec 2023、Jun 2021 等),而不是按时间顺序。在画图或对比季度之前,请先在自己的代码里把每个标签解析成日期再排序。
数据用的是什么单位?
除了 EPS 的 Rs 标签以及 OPM % 和 Tax % 这两行百分比之外,示例没有说明单位。把数字用于模型之前,请对照公司自己的备案文件核实金额的量级。
需要提供 NSE 代码或 BSE 证券代码吗?
stock_name 被描述为公司名称,示例中使用的是 TCS 和 TATAMOTORS。接口如何处理不完整或拼错的名称尚未验证,所以对有歧义的名称,请先用行业搜索接口查询,它会返回 NSE 和 BSE 代码。