按公司名称查询印度股票完整详情: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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 回复 Telegram 或 WhatsApp 里“Reliance 股价”这类消息,直接用用户输入的自由文本公司名,并排给出 BSE 和 NSE 报价。
- 为研究笔记生成一页纸的公司简报,一次调用即可拼出财务数据、关键指标、分析师观点和持股结构。
- 定时对比 currentPrice.BSE 与 currentPrice.NSE,监控双重上市公司在两个交易所之间的价差。
- 制作资讯邮件的“今日个股”卡片,把 recentNews 标题与 riskMeter 分类以及 yearHigh、yearLow 区间放在一起展示。
- 为用户手动输入的持仓补充行业、年内最高最低价和交易所代码,而无需自己维护股票代码对照表。
常见问题
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。