随着印度经济的飞速发展，印度国家证券交易所（NSE）和孟买证券交易所（BSE）已成为全球投资者关注的焦点。对于开发者而言，如何稳定、实时地获取印度数千只股票的行情数据是构建金融产品的核心。
本文将演示如何使用 StockTV API，通过指定 countryId=14 快速接入印度的实时行情、指数、K线及排行榜数据。
一、 接入准备：获取权限
- 认证密钥：所有请求必须携带
key参数。您可以联系 StockTV 官方 获取您的专属 Key。 - 基准参数：在 StockTV 系统中，印度的唯一标识符是
countryId=14。 - 数据协议：支持标准的 HTTP GET 请求，返回数据格式为 JSON。
二、 印度市场核心接口清单
1. 实时指数查询（如 Nifty 50）
获取印度大盘指数是监控市场情绪的第一步。
- 接口地址：
https://api.stocktv.top/stock/indices - 请求示例：
?countryId=14&key=YOUR_KEY - 关键返回：包含
Nifty 50 (NSEI)等主流指数的最新价 (last)、涨跌幅 (chgPct) 以及精确的时间戳 (time)。
2. 印度股票市场列表与行情
批量获取印度上市公司的实时报价。
- 接口地址：
https://api.stocktv.top/stock/stocks - 请求示例：
?countryId=14&pageSize=20&page=1&key=YOUR_KEY - 实时性字段：
last: 毫秒级更新的最新价。chgPct: 实时涨跌百分比。exchangeId: 46 代表 NSE（印度国家证券交易所），74 代表 BSE（孟买证券交易所）。
3. 实时 K 线数据
对接图表系统，支持从 1分钟到月线的实时 K 线合成。
- 接口地址：
https://api.stocktv.top/stock/kline - 参数配置：
pid=产品ID&interval=PT1H（获取1小时 K 线）。
4. 印度股市排行榜（异动监控）
实时获取印度市场的涨幅榜、跌幅榜。
- 接口地址：
https://api.stocktv.top/stock/updownList - 参数：
countryId=14&type=1（1-涨幅榜，2-跌幅榜）。
三、 极致实时性保障：WebSocket vs HTTP
为了满足不同场景对延迟的要求，StockTV 提供了两种数据获取模式：
- HTTP 模式：适用于展示股票列表、查询个股详情或非高频更新的仪表盘。
- WebSocket (WS) 模式：推荐方案。对于交易终端、毫秒级跳动的盘面行情，WS 模式能实现服务器主动推送，极大地降低网络延迟。
四、 进阶功能：公司背景与 IPO 日历
除了行情，StockTV 还提供了丰富的基本面数据：
- 公司信息：通过
https://api.stocktv.top/stock/companies?countryId=14获取印度公司的行业板块、员工人数及详细描述。 - IPO 日历：监控印度市场即将上市的新股信息（
https://api.stocktv.top/stock/getIpo?countryId=14）。
五、 Python 示例代码：获取印度特定股票
以下代码演示如何获取印度知名股票（如 Reliance）的实时行情：
import requests
def get_india_stock_quote(symbol):
url = "https://api.stocktv.top/stock/queryStocks"
params = {
"symbol": symbol, # 例如: RELI
"key": "您的API_KEY"
}
response = requests.get(url, params=params)
data = response.json()
if data['code'] == 200:
stock = data['data'][0]
print(f"公司: {stock['name']}")
print(f"最新价: {stock['last']}")
print(f"涨跌: {stock['chgPct']}%")
print(f"更新时间: {stock['time']}")
else:
print(f"错误: {data['message']}")
# 查询示例
get_india_stock_quote("RELI")
六、 结语
对接印度市场从未如此简单。通过 StockTV 的统一接口，即可瞬间打通印度两大会计交易所的所有核心数据通道。
