掘金南亚市场：StockTV 印度股票数据 API 对接实战（极致实时性）

随着印度经济的飞速发展，印度国家证券交易所（NSE）和孟买证券交易所（BSE）已成为全球投资者关注的焦点。对于开发者而言，如何稳定、实时地获取印度数千只股票的行情数据是构建金融产品的核心。

本文将演示如何使用 **StockTV API**，通过指定 `countryId=14` 快速接入印度的实时行情、指数、K线及排行榜数据。

---

### 一、 接入准备：获取权限

1. **认证密钥**：所有请求必须携带 `key` 参数。您可以联系 StockTV 官方 获取您的专属 Key。

2. **基准参数**：在 StockTV 系统中，印度的唯一标识符是 `countryId=14`。

3. **数据协议**：支持标准的 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）的实时行情：

```python

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 的统一接口，即可瞬间打通印度两大会计交易所的所有核心数据通道。