印度股票数据API对接实战（实时行情与IPO功能全解析）

随着印度经济的飞速发展，印度股市（NSE 印度国家证券交易所和 BSE 孟买证券交易所）已成为全球投资者不容忽视的资产配置高地。对于开发者而言，如何稳定、高效地接入印度股票数据？

本文将基于 **StockTV API**，带你实现印度股票（**countryId=14**）的深度对接，重点突出**秒级实时性**与**IPO新股功能**。

## 一、 对接核心配置

在开始开发前，请明确以下基础参数：

* **API 基础路径**：`https://api.stocktv.top`

* **国家 ID (countryId)**：`14`（印度市场专属代码，同时覆盖 NSE 与 BSE）

* **接入协议**：支持标准的 HTTP RESTful 接口（用于列表和历史数据）以及 WebSocket (WS) 协议（用于高频实时数据推送）。

* **身份认证**：在 API 请求参数中携带您的 `key` 即可。

## 二、 核心功能一：极致的实时行情体验

在金融应用中，延迟是交易的天敌。针对印度市场，该接口提供了多维度的实时数据支持。

### 1. 获取全市场实时列表

通过 `/stock/stocks` 接口并传入 `countryId=14`，你可以实时获取印度市场所有活跃个股的最新成交价、涨跌幅及成交量。

* **实时字段**：

* `last`: 最新成交价（秒级刷新）。

* `chgPct`: 涨跌幅百分比。

* `volume`: 当日累计成交量。

* **应用场景**：自选股列表、实时行情板、涨跌幅排行榜。

### 2. 大盘指数实时监控

监控印度市场离不开 **Nifty 50** 和 **SENSEX**。

* **接口地址**：`/stock/indices?countryId=14`

* **关键点**：提供 `isOpen` 字段，实时反馈印度市场是否处于交易时段。

### 3. WebSocket 毫秒级推送

如果您正在开发交易终端或高频监控系统，建议使用 WebSocket 接入。通过订阅印度股票频道，一旦价格产生波动，服务器将主动推送最新报价，无需客户端轮询。

## 三、 核心功能二：IPO 新股日历功能

印度 IPO 市场非常活跃（如近年来备受关注的 Zomato、Paytm 等）。该 API 提供了完善的 IPO 数据链路。

### 1. 追踪待上市新股 (`type=1`)

通过 `/stock/getIpo?countryId=14&type=1`，你可以提前获取即将上市的公司信息。

* **核心数据**：

* `ipoListing`: 预计上市时间戳。

* `ipoPrice`: 发行价格。

* `company`: 公司名称及所属行业。

### 2. 回测已上市表现 (`type=2`)

对于分析新股首日表现和后续走势，已上市 IPO 列表提供了关键的历史参考。

### 3. 应用价值

开发者可以利用此功能构建“打新提醒”通知系统，通过 APP 推送或邮件告知用户最新的印度 IPO 动态，增强用户粘性。

## 四、 快速集成示例 (Python)

以下是一个简单的代码片段，展示如何获取印度市场的实时股票数据：

```python

import requests

def get_india_live_data():

api_url = "https://api.stocktv.top/stock/stocks"

params = {

"countryId": 14, # 印度

"key": "YOUR_API_KEY",

"pageSize": 10

}

response = requests.get(api_url, params=params)

if response.status_code == 200:

stocks = response.json().get('data', {}).get('records', [])

for stock in stocks:

print(f"代码: {stock['symbol']}, 最新价: {stock['last']}, 涨跌幅: {stock['chgPct']}%")

get_india_live_data()

```

## 五、 为什么选择 StockTV 对接印度数据？

1. **统一架构**：仅需变更 `countryId`，即可在同一套逻辑下切换至美国、日本、越南等全球多国市场。

2. **深度基本面**：除了价格，通过 `/stock/companies` 接口还可获取印度上市公司的详细描述、所属板块及员工人数。

3. **技术支持**：提供全程对接辅助，确保从 HTTP 到 WebSocket 的平滑过渡。

---

**结语**：印度股市的数字化投资时代已经到来。利用专业的 API 接口，您可以仅用几行代码，就让您的应用具备与华尔街终端同步的印度市场洞察力。立即开始集成，抢占南亚市场先机！