印度作为全球增长最快的主要经济体之一，其证券交易所（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 提供两种数据分发模式，满足不同对延迟敏感的场景：
- HTTP 模式: 适合列表展示和基础行情查询，开发成本极低。
- WebSocket (WS) 模式: 适合交易终端。服务器在价格变动瞬间主动推送，延迟可达毫秒级，是开发高频监控应用的首选。
