印度股市数据集成指南：利用 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 接入示例

import requests

def get_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()
    
    if data['code'] == 200:
        for stock in data['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) 模式: 适合交易终端。服务器在价格变动瞬间主动推送，延迟可达毫秒级，是开发高频监控应用的首选。