印度股票数据API对接文档

1. 接口概述

StockTV提供印度股票市场的实时行情数据接口，包括：

• 印度NSE和BSE交易所的股票实时行情
• 指数数据(Nifty 50, SENSEX等)
• 历史K线数据
• 公司基本信息
• IPO新股信息
• 涨跌排行榜

支持HTTP REST API和WebSocket两种接入方式，毫秒级延迟，7×24小时稳定服务。

2. 获取API Key

使用前需联系StockTV获取API Key：

• 官网
• 联系方式

3. 印度股票接口列表

3.1 获取印度股票列表

接口地址
GET /stock/stocks

请求参数

参数名	必填	类型	说明
countryId	是	int	印度国家ID为14
pageSize	否	int	每页数量，默认10
page	否	int	页码，默认1
key	是	string	API密钥

请求示例

GET https://api.stocktv.top/stock/stocks?countryId=14&pageSize=10&page=1&key=您的API_KEY

响应示例

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 41602,
        "symbol": "TCS", 
        "name": "Tata Consultancy",
        "last": 3856.15,
        "chg": 12.45,
        "chgPct": 0.32,
        "high": 3872.30,
        "low": 3825.60,
        "volume": 1254875,
        "exchangeId": 46, // 46=NSE, 74=BSE
        "countryId": 14,
        "open": true // 是否开市
      },
      ...
    ],
    "total": 1850
  }
}

3.2 查询特定股票

接口地址
GET /stock/queryStocks

请求参数

参数名	必填	类型	说明
id	否	int	股票ID
symbol	否	string	股票代码如"RELIANCE"
name	否	string	股票名称
key	是	string	API密钥

请求示例

GET https://api.stocktv.top/stock/queryStocks?symbol=RELIANCE&key=您的API_KEY

3.3 获取印度指数数据

接口地址
GET /stock/indices

请求参数

参数名	必填	类型	说明
countryId	是	int	印度国家ID为14
key	是	string	API密钥

响应示例

{
  "code": 200,
  "data": [
    {
      "id": 17940,
      "name": "Nifty 50",
      "symbol": "NSEI",
      "last": 22967.65,
      "chg": 369.85,
      "chgPct": 1.64
    },
    {
      "id": 17941,
      "name": "S&P BSE SENSEX",
      "symbol": "BSESN", 
      "last": 75385.24,
      "chg": 412.56,
      "chgPct": 0.55
    }
  ]
}

3.4 获取K线数据

接口地址
GET /stock/kline

请求参数

参数名	必填	类型	说明
pid	是	int	股票ID
interval	是	string	时间间隔: PT5M,PT15M,PT1H,P1D等
key	是	string	API密钥

请求示例

GET https://api.stocktv.top/stock/kline?pid=7310&interval=PT15M&key=您的API_KEY

响应示例

{
  "code": 200,
  "data": [
    {
      "time": 1719818400000,
      "open": 239.42,
      "high": 239.6,
      "low": 239.42,
      "close": 239.6,
      "volume": 12500
    },
    ...
  ]
}

3.5 WebSocket实时数据

连接地址
wss://ws-api.stocktv.top/connect?key=您的API_KEY

订阅消息格式

{
  "action": "subscribe",
  "pids": [41602, 17940] // 股票ID和指数ID数组
}

实时推送数据示例

{
  "pid": 41602,
  "symbol": "TCS",
  "last": 3856.75,
  "chg": 12.45,
  "chgPct": 0.32,
  "volume": 1254875,
  "timestamp": 1725002394
}

4. 示例代码

Python HTTP请求示例

import requests

# 获取印度股票列表
url = "https://api.stocktv.top/stock/stocks"
params = {
    "countryId": 14,
    "pageSize": 10,
    "key": "您的API_KEY"
}
response = requests.get(url, params=params)
print(response.json())

# 获取Nifty 50指数数据
index_url = "https://api.stocktv.top/stock/indices"
index_params = {
    "countryId": 14,
    "key": "您的API_KEY"
}
index_data = requests.get(index_url, params=index_params).json()
print(index_data)

JavaScript WebSocket示例

const ws = new WebSocket("wss://ws-api.stocktv.top/connect?key=您的API_KEY");

ws.onopen = () => {
  console.log("Connected");
  // 订阅TCS股票和Nifty指数
  ws.send(JSON.stringify({
    action: "subscribe",
    pids: [41602, 17940]
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log("Received:", data);
};

5. 注意事项

1. 所有API请求必须包含有效的key参数
2. 印度市场交易时间：IST 9:15-15:30（周一至周五）
3. 实时数据通过WebSocket推送更高效
4. 历史数据可通过K线接口获取

如需更多帮助，请联系：

• 官网
• 文档
• Demo代码