获取当前印度股票涨幅榜和跌幅榜,含价格、涨跌幅、涨跌停限价、趋势标签和 52 周价格区间。
查看 印度股票交易所 API 的全部接口 →以单个 JSON 对象返回当前印度股票的涨幅榜和跌幅榜快照。请求不带任何参数,文档中也没有提到交易所、数量或行业筛选。响应体只有一个 trending_stocks 容器,内含 top_gainers 和 top_losers 两个数组。实际探测(HTTP 200)显示:每个数组各有 10 行,行内的所有值都是字符串,同一列表中的行键名一致,包括 ticker_id、company_name、price、percent_change、net_change、open、high、low、close、bid、ask、bid_size、ask_size、volume、low_circuit_limit、up_circuit_limit、year_low、year_high、date、time、lot_size、exchange_type、ric、overall_rating、short_term_trends、long_term_trends 和 total_share_outstanding。在该次探测中,每一行的 exchange_type 都是 NSI,ric 都以 .NS 结尾;top_gainers 从涨幅最大的正 percent_change 开始,top_losers 从跌幅最大的负值开始;趋势字段使用 Bullish、Moderately Bullish、Neutral、Moderately Bearish 和 Bearish 等标签。文档与探测结果有三处不同,应视为未经验证:文档称每个列表只有前 3 只股票;文档示例是 ric 以 .BO 结尾的 BSE 行;文档还列出 average_price、average_volume、deviation、actual_deviation 和 no_of_days_for_average 等额外字段,而探测到的行里并没有出现。文档另外说明会移除空值,因此可选字段可能不存在。这些数据仅是信息性的市场快照,不是交易执行行情,也不是持牌的逐笔行情源。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/indian-stock-exchange-api/get-trending-stocks 无需参数,点击查询即可调用 API。
API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/get-trending-stocks?key=<API_KEY>'
查询结果
使用场景
- 驱动财经网站的滚动行情条,展示涨幅榜和跌幅榜个股的公司名称、价格和 percent_change。
- 发送每日市场情绪邮件,把当天分为涨榜和跌榜两部分,并用一句话说明各只异动股距离涨跌停限价还有多远。
- 当异动股价格逼近 up_circuit_limit 或 low_circuit_limit 时触发提醒,让交易台知道这只股票可能很快就要在当日封板。
- 每天保存涨榜和跌榜数据,做次日收益研究,检验大幅异动的股票是延续还是反转。
- 直接复用每只异动股已有的 short_term_trends 与 long_term_trends 标签,为研究表格增加一列情绪标记。
常见问题
这个接口接受任何参数吗?
不接受。请求是对 /trending 的普通 GET,不带查询参数,文档中也没有描述交易所、行业或结果数量的筛选。如果需要只看某一个交易所或使用别的排序,请改用 BSE 或 NSE 成交最活跃列表,或价格异动股列表这类专用接口。
每个列表里有多少只股票?
文档写的是前 3 名涨幅股和前 3 名跌幅股,但探测时 top_gainers 和 top_losers 各返回了 10 行。请把长度视为可变,遍历数组实际包含的内容,不要在代码里写死数量。
异动股来自 BSE 还是 NSE?
文档示例是 ric 以 .BO 结尾的 BSE 行,而探测返回的行 exchange_type 为 NSI,ric 以 .NS 结尾。交易所无法选择,所以请读取每一行的 exchange_type 和 ric 后缀来判断,不要预先假定是某一个交易所。
为什么所有数值都是字符串?
探测中每一行的所有值,包括 price、percent_change、volume 和涨跌停限价,全部是字符串。排序或计算之前,请先在客户端转换成数字。文档还说明会移除空值,所以某些行里可能缺少你预期的字段。
为什么我的响应里没有 average_price 和 deviation?
文档列出了 average_price、average_volume、deviation、actual_deviation 和 no_of_days_for_average,但探测到的行里没有这些字段。它们看起来是可选的,读取前请先检查键是否存在。探测到的行里有 total_share_outstanding,而文档并没有列出这个字段。
top_gainers 和 top_losers 是怎么排序的?
文档说明两个列表按涨跌幅排名。探测中 top_gainers 从最大的正 percent_change 开始,top_losers 从最负的值开始,所以两个数组的第一个元素都是波动最强的个股。如果你的逻辑依赖这一点,建议自行按 percent_change 再排一次序作为保险。
数据有多新?可以据此交易吗?
每一行都有 date 和 time 字段,可以看到报价的时间戳,但文档没有给出刷新间隔。请把响应当作用于看板、机器人和研究的信息性市场快照,不要当作交易执行行情,也不要当作持牌的逐笔行情源。
它和成交最活跃、价格异动股接口有什么区别?
本接口按涨跌幅排名,只返回涨幅榜和跌幅榜。成交最活跃接口按成交量排名,价格异动股接口则关注价格大幅偏离近期均值的股票,三者回答的是不同的选股问题。