按公司名称查询印度股票的季度业绩、年度业绩、资产负债表、现金流、财务比率和持股历史

查看 印度股票交易所 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 功能

一个参数选择七类统计分组 stats 参数用来指定要返回的分组:quarter_results、yoy_results、balancesheet、cashflow、ratios、shareholding_pattern_quarterly 和 shareholding_pattern_yearly。文档默认值包含全部七类。
按会计科目组织的季度业绩 来源示例是一个以会计科目为键的对象,包含 Sales、Expenses、Operating Profit、Net Profit 以及以卢比计的 EPS,每个科目对应 13 个季度的数值,可以直接转成表格。
附带利润率与税率百分比 示例中除绝对金额外还有 OPM % 和 Tax % 两行,因此画利润率和税率趋势时,不必再用 Sales 和税前利润自行计算。
季度与年度两类持股分组 文档列出的 stats 取值中有 shareholding_pattern_quarterly 和 shareholding_pattern_yearly 两个持股分组,可用来跟踪股东结构随时间的变化;它们的响应结构尚未验证。
期间标签直接作为对象键 每个科目把 Jun 2024、Mar 2023 这样的标签映射到数值。示例中的标签按字母顺序排列,画图前请在自己的代码里把标签解析成日期并重新排序。
用公司名称而不是证券代码 stock_name 接受 TCS 或 TATAMOTORS 这样的普通名称,查询业绩时不需要先找到 BSE 证券代码或某个交易所专用的标识符。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

历史统计接口会返回什么?

返回所查公司的财务统计数据,是一个 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 代码。

相关接口

相关指南

查看订阅方案 →