按公司名称查询印度股票完整详情:BSE 与 NSE 价格、财务数据、关键指标、分析师观点、持股结构和近期新闻。

查看 印度股票交易所 API 的全部接口 →

按公司名称查询一家印度上市公司,返回包含其详情记录的单个 JSON 对象。唯一的输入是必填查询参数 name,可填写公司全称、简称或股票的通用名称;文档中的示例请求使用 Reliance,目录默认值为 tata steel,无需提供股票代码或 BSE 证券代码。以 name=tata steel 做实时探测(HTTP 200)时观察到:companyName、industry、包含 BSE 与 NSE 两个取值的 currentPrice(以字符串返回)、percentChange、yearHigh 和 yearLow、stockTechnicalData(5、10、20、50、100、300 日共六行,每行含 bsePrice 与 nsePrice)、companyProfile(companyDescription、mgIndustry、isInId、exchangeCodeBse、exchangeCodeNse、officers 和 peerCompanyList)、financials(19 条期间记录,stockFinancialMap 以 CAS、BAL、INC 为键,并带有 FiscalYear、EndDate 及 Annual 或 Interim 类型)、keyMetrics(八个分组:mgmtEffectiveness、margins、financialstrength、valuation、incomeStatement、growth、persharedata、priceandVolume)、analystView(从 Strong Buy 到 Strong Sell 的评级行外加 Total 行,含当前以及 1 周、1 个月、2 个月、3 个月前的分析师人数)、recosBar(评级区间、noOfRecommendations、meanValue、tickerPercentage)、riskMeter(categoryName 和 stdDev)、shareholding(四类持股主体及带日期的持股比例)、stockCorporateActionData(bonus、dividend、rights、splits、annualGeneralMeeting、boardMeetings)、stockDetailsReusableData(含日期、时间、价格、市值和估值比率的报价块)、stockFinancialData 以及 recentNews(十篇文章,含 headline、date、summary 和 url)。该次探测中,futureExpiryDates、futureOverviewData 和 initialStockFinancialData 为 null,companyProfile 内的刷新状态字段存在但为 null。文档还展示了顶层的 tickerId 和数值型价格,但探测响应中没有顶层 tickerId,价格也是字符串,因此文档示例中的这些细节尚未得到验证。数据仅为资讯性质的市场快照,不是交易执行或持牌的逐笔行情源。

API 功能

输入公司名,直接返回完整记录 只需一个必填的 name 参数,可填完整名称、简称或 tata steel、Reliance 这类常用名,应用无需先维护股票代码表或做 BSE 证券代码查询,就能取到数据。
BSE 与 NSE 价格同在一个对象 currentPrice 分别给出 BSE 和 NSE 的取值,stockTechnicalData 另有 5、10、20、50、100、300 日六行 bsePrice 与 nsePrice,无需第二次请求即可对比两个交易所。
年度与中期财务报表 探测中 financials 数组含 19 条期间记录,每条带有以 CAS、BAL、INC 为键的 stockFinancialMap、FiscalYear、EndDate 以及 Annual 或 Interim 类型,可直接用来搭建报表表格。
八组关键指标 keyMetrics 把比率拆成 mgmtEffectiveness、margins、financialstrength、valuation、incomeStatement、growth、persharedata 和 priceandVolume 八个列表,页面按需取用某一组,不必解析一整块扁平数据。
带历史评级的分析师观点 analystView 列出 Strong Buy、Buy、Hold、Sell、Strong Sell 及 Total 行,给出最新以及 1 周、1 个月、2 个月、3 个月前的分析师人数,recosBar 再补充平均评级和推荐数量。
持股、风险等级与公司行动 同一条记录还包含带日期的持股比例(控股股东、FII、共同基金及其他持有人)、带 stdDev 的 riskMeter 分类,以及 bonus、dividend、rights、split、AGM 和董事会会议列表。
响应内附近期新闻 探测中 recentNews 返回十篇文章,每篇含 headline、date、timeToRead、summary 和 url,公司卡片可以在数字旁边直接展示相关背景。

在线 API 演示

GET /api/project/indian-stock-exchange-api/get-stock-data-by-name

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/get-stock-data-by-name?key=<API_KEY>&name=tata+steel'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

name 参数可以填什么?

name 为必填项,可填写公司全称、简称或股票的通用名称。目录默认值 tata steel 在探测中返回 HTTP 200,文档示例请求使用 Reliance。文档没有说明能否传入股票代码或 BSE 证券代码,依赖这类输入前请自行测试。

名称没有匹配到任何公司或匹配到多家公司会怎样?

现有资料没有记载未找到时的响应或多结果的消歧规则,而且只探测过 tata steel 这一次调用。建议在客户端检查状态码以及 companyName 是否存在;如果输入是用户手输的自由文本,可考虑先通过股票搜索接口确认公司。

响应包含哪些价格字段,格式是什么?

currentPrice 含 BSE 和 NSE 两个成员,percentChange、yearHigh 和 yearLow 位于顶层,stockTechnicalData 则给出 5、10、20、50、100、300 日的 bsePrice 与 nsePrice。探测中这些价格是十进制文本形式的字符串,而文档示例显示的是数字,所以解析时请做好容错。

响应顶层有 tickerId 吗?

文档示例在顶层显示了 tickerId,但 tata steel 的探测响应里没有。实际出现的标识符有 companyProfile.exchangeCodeNse、companyProfile.exchangeCodeBse 和 companyProfile.isInId,peerCompanyList 中的每个条目也带有各自的 tickerId。

为什么 futureExpiryDates 和 futureOverviewData 是 null?

在 tata steel 的探测中,futureExpiryDates、futureOverviewData 和 initialStockFinancialData 返回 null。文档把它们列为与期货相关的部分,但没有说明何时会有数据,因此请视为可选字段,读取前先判断是否为 null。

数据是实时的吗?能据此交易吗?

文档没有做任何保证。stockDetailsReusableData 的报价块带有日期和时间字段,但更新频率未说明。请把响应当作用于看板、机器人和研究的资讯性市场快照,不要当作交易执行行情或持牌的逐笔数据源。

同一家公司的价格历史或分析师预测去哪里取?

本接口只返回当前快照以及按天数划分的简短价格行。更长的价格序列、季度和年度统计以及前瞻性预测由本目录中的其他接口提供,例如 historical data、historical stats 和 stock forecasts。

相关接口

相关指南

查看订阅方案 →