印度股市近年来已成为全球表现最亮眼的权益资产市场之一。对于开发者和金融机构而言，获取 NSE（印度国家证券交易所） 和 BSE（孟买证券交易所） 的实时行情、指数波动及新股（IPO）数据，是构建金融分析工具和交易平台的关键。
本文将详细介绍如何使用 StockTV API快速实现印度全市场数据的闭环对接。
一、 为什么选择 StockTV 对接印度市场？
- 全面覆盖：同时支持 NSE 和 BSE 两大交易所的个股数据。
- 极速实时：提供秒级刷新的实时价格、成交量及盘口变动。
- 多维数据：除了价格，还涵盖 IPO 日历、大盘指数及公司深度基本面。
- 极简接入：标准的 RESTful API，几分钟内即可完成环境配置。
二、 核心对接参数
- API 基地址：
https://api.stocktv.top - 国家标识 (countryId)：
14（印度专有代码） - 核心功能：实时行情、K 线历史、IPO 追踪、大盘指数。
三、 核心接口功能实战
1. 实时行情：获取 BSE/NSE 个股变动
通过 countryId=14，你可以一次性调取印度市场中所有活跃股票的最新价、涨跌幅及成交量。
- 接口地址：
/stock/stocks - 请求示例：
```http
GET https://api.stocktv.top/stock/stocks?countryId=14&pageSize=15&page=1&key=YOUR_KEY
* **关键返回字段**：
* `last`: 最新成交价（实时同步）。
* `chgPct`: 涨跌幅百分比。
* `volume`: 成交量（反映市场流动性）。
### 2. 大盘指数：监控 Nifty 50 与 Sensex
作为印度股市的风向标，Nifty 50（NSE）和 Sensex（BSE）的波动至关重要。
* **接口地址**：`/stock/indices?countryId=14`
* **优势**：实时提供指数的开关盘状态 (`isOpen`) 和实时点位，助你精准把握市场情绪。
### 3. IPO 追踪：捕捉新股上市机会
印度 IPO 市场极其活跃。利用此接口，你可以轻松区分“待上市”与“已上市”的新股信息。
* **接口地址**：`/stock/getIpo?countryId=14&type=1`
* **数据亮点**：包含 `ipoListing` (预计上市日期) 和 `ipoPrice` (发行价)，是构建打新提醒功能的必备数据。
### 4. 专业 K 线：支持技术分析图表
提供从 1 分钟到月线的全周期 K 线数据，满足绘制 TradingView 等专业图表的需求。
* **接口地址**：`/stock/kline`
* **参数**：传入 `pid`（股票 ID）和 `interval`（如 `PT1M`, `PT1H`, `P1D`）。
## 四、 代码实现：快速获取实时数据 (Node.js)
```javascript
const axios = require('axios');
const API_KEY = 'YOUR_API_KEY';
const INDIA_COUNTRY_ID = 14;
async function fetchIndiaMarket() {
try {
const response = await axios.get('https://api.stocktv.top/stock/stocks', {
params: {
countryId: INDIA_COUNTRY_ID,
key: API_KEY,
pageSize: 10
}
});
const stocks = response.data.data.records;
console.log('--- 印度 BSE/NSE 实时行情 ---');
stocks.forEach(s => {
console.log(`代码: ${s.symbol}, 名称: ${s.name}, 现价: ${s.last}, 涨幅: ${s.chgPct}%`);
});
} catch (error) {
console.error('对接失败:', error.message);
}
}
fetchIndiaMarket();
五、 为什么开发者青睐 StockTV？
- 数据清洗：原始交易所数据经过清洗后以统一格式输出，大幅降低后端处理成本。
- 公司背景：通过
/stock/companies接口，可直接调取公司所属板块（Sector）和详细业务介绍。 - 高并发支持：支持 WebSocket 接入方案，满足高频刷新场景需求。
结语：印度市场的崛起带来了前所未有的机遇。您可以快速为用户提供专业、稳定的 BSE 和 NSE 实时行情服务。立即开始，为您的金融产品注入强大的数据驱动力！
