印度股市近年来已成为全球表现最亮眼的权益资产市场之一。对于开发者和金融机构而言，获取 NSE（印度国家证券交易所） 和 BSE（孟买证券交易所） 的实时行情、指数波动及新股（IPO）数据，是构建金融分析工具和交易平台的关键。
本文将详细介绍如何使用 StockTV API快速实现印度全市场数据的闭环对接。
一、 为什么选择 StockTV 对接印度市场？
二、 核心对接参数
- API 基地址：https://api.stocktv.top
- 国家标识 (countryId)：14 （印度专有代码）
- 核心功能：实时行情、K 线历史、IPO 追踪、大盘指数。
三、 核心接口功能实战
1. 实时行情：获取 BSE/NSE 个股变动
通过 countryId=14，你可以一次性调取印度市场中所有活跃股票的最新价、涨跌幅及成交量。
- 接口地址：/stock/stocks
- 请求示例：
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)
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？
结语：印度市场的崛起带来了前所未有的机遇。您可以快速为用户提供专业、稳定的 BSE 和 NSE 实时行情服务。立即开始，为您的金融产品注入强大的数据驱动力！
