印度股市数据集成指南：利用 StockTV API 快速接入 NSE/BSE 实时行情

印度作为全球增长最快的主要经济体之一，其证券交易所（NSE 和 BSE）吸引了大量国际量化交易者和金融科技开发者。通过 StockTV API，您仅需使用countryId=14即可轻松调取涵盖 Nifty 50 指数、数千只个股以及 IPO 日历在内的全维度金融数据。

一、 核心接入参数

在进行任何 API 调用前，请确保您已准备好以下基础配置：

• 国家 ID (countryId):14。
• 交易所 ID (exchangeId):46代表印度国家证券交易所 (NSE)，74代表孟买证券交易所 (BSE)。
• 身份验证: 需在所有请求中携带key参数。

二、 核心接口说明

1. 印度股票市场列表

获取印度市场所有股票的实时行情快照，包括最新价、涨跌幅、成交量等核心指标。

• 接口地址:https://api.stocktv.top/stock/stocks
• 请求示例:?countryId=14&pageSize=10&page=1&key=YOUR_KEY
• 关键返回字段:
• last: 最新成交价。
• chgPct: 实时涨跌幅（直接拼接 % 即可展示）。
• technicalDay: 日线技术指标建议（如strong_buy）。

2. 实时指数获取（如 Nifty 50）

监控印度大盘走势的必备接口。

• 接口地址:https://api.stocktv.top/stock/indices
• 请求参数:countryId=14&key=YOUR_KEY
• 示例: 返回Nifty 50 (NSEI)指数的最高、最低、涨跌额及毫秒级时间戳。

3. 实时 K 线图表

支持从 1 分钟到 1 月的多种时间频率，满足图表渲染和量化策略需求。

• 接口地址:https://api.stocktv.top/stock/kline
• 参数配置:pid={产品ID}&interval=PT1H（获取 1 小时 K 线）。
• 间隔选项:PT1M(1分),PT15M(15分),PT1H(1时),P1D(天) 等。

4. 印度股市排行榜（涨跌监控）

实时获取市场异动个股，支持涨幅榜和跌幅榜。

• 接口地址:https://api.stocktv.top/stock/updownList
• 请求参数:countryId=14&type=1（type=1涨幅榜，type=2跌幅榜）。

5. 印度 IPO 与新股日历

监控印度市场即将上市或已上市的新股动向。

• 接口地址:https://api.stocktv.top/stock/getIpo
• 参数示例:countryId=14&type=1（1 为未上市，2 为已上市）。

三、 深度数据：公司信息与基本面

除了价格跳动，API 还提供了丰富的静态数据：

• 公司信息: 调用https://api.stocktv.top/stock/companies?countryId=14获取印度公司的行业 (Industry)、板块 (Sector)、员工人数及公司详细描述。

四、 快速上手：Python 接入示例

importrequestsdefget_indian_market_top_stocks():url="https://api.stocktv.top/stock/stocks"params={"countryId":"14",# 印度"pageSize":"5","key":"YOUR_API_KEY"# 替换为您的 Key}response=requests.get(url,params=params)data=response.json()ifdata['code']==200:forstockindata['data']['records']:print(f"代码:{stock['symbol']}| 名称:{stock['name']}| 现价:{stock['last']}")else:print("请求失败:",data['message'])get_indian_market_top_stocks()

五、 实时性保障方案

StockTV 提供两种数据分发模式，满足不同对延迟敏感的场景：

1. HTTP 模式: 适合列表展示和基础行情查询，开发成本极低。
2. WebSocket (WS) 模式: 适合交易终端。服务器在价格变动瞬间主动推送，延迟可达毫秒级，是开发高频监控应用的首选。