印度股票数据API对接实战指南（含完整代码）

---

🔑 一、准备工作

1. 获取API Key

   • 联系官方https://t.me/stocktvpaopao 申请密钥
   • 密钥格式示例：MY4b781f618e3f43c4b055f25fa61941ad

2. 基础参数配置

   # 关键参数说明
   countryId = 14    # 印度市场固定ID
   exchangeId = 46   # NSE（国家交易所）
   exchangeId = 74   # BSE（孟买交易所）
   

---

⚙️ 二、核心API接口详解

1. 获取印度股票列表

def get_indian_stocks():
    url = "https://api.stocktv.top/stock/stocks"
    params = {
        "countryId": 14,     # 印度
        "pageSize": 100,     # 每页数量
        "exchangeId": 46,    # NSE交易所
        "key": API_KEY       # 替换为你的Key
    }
    return requests.get(url, params=params).json()

返回字段：股票ID、代码、名称、最新价、涨跌幅、成交量

---

2. 查询指定股票实时行情

def query_stock(stock_id):
    url = "https://api.stocktv.top/stock/queryStocks"
    params = {"id": stock_id, "key": API_KEY}
    return requests.get(url, params=params).json()

---

3. 获取印度指数数据（Nifty 50/Sensex）

def get_indices():
    url = "https://api.stocktv.top/stock/indices"
    params = {"countryId": 14, "key": API_KEY}
    return requests.get(url, params=params).json()

返回示例：

{
  "symbol": "NSEI",         // 指数代码
  "last": 22967.65,         // 最新点位
  "chgPct": 1.64            // 涨跌幅(%)
}

---

4. 获取K线数据（支持多粒度）

def get_kline(pid, interval="PT15M"):
    url = "https://api.stocktv.top/stock/kline"
    params = {
        "pid": pid,          # 股票ID
        "interval": interval, # 时间粒度
        "key": API_KEY
    }
    return requests.get(url, params=params).json()

支持粒度：

• PT5M（5分钟）
• PT1H（1小时）
• P1D（日线）

---

🚀 三、高级功能接口

1. IPO新股日历

def get_ipo_calendar():
    url = "https://api.stocktv.top/stock/getIpo"
    params = {
        "countryId": 14,   # 印度
        "type": 1,         # 1=即将上市 2=已上市
        "key": API_KEY
    }
    return requests.get(url, params=params).json()

---

2. 实时涨跌排行榜

def get_top_gainers():
    url = "https://api.stocktv.top/stock/updownList"
    params = {
        "countryId": 14,
        "type": 1,  # 1=涨幅榜 2=跌幅榜
        "key": API_KEY
    }
    return requests.get(url, params=params).json()

---

3. WebSocket实时推送（前端示例）

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

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(`股票 ${data.pid} 最新价: ${data.last}`);
};

// 心跳维持（每30秒）
setInterval(() => ws.send("ping"), 30000);

返回字段：股票ID、最新价、涨跌幅、成交量、时间戳

---

⚠️ 四、避坑指南

1. 频率限制

   • REST API：≤10次/分钟
   • WebSocket：实时推送（延迟<1秒）

2. 时区处理

   from pytz import timezone
   ist = timezone('Asia/Kolkata')  # 印度时区转换
   

3. 错误处理

   if response.status_code != 200:
       print(f"Error {response.status_code}: {response.text}")
   

4. 数据源可靠性

   • 直连NSE/BSE交易所官方数据源

---

💡 结语

StockTV API提供覆盖实时行情、历史K线、期权链、机构持仓的完整印度股票数据解决方案，通过简单调用即可快速构建量化交易系统或投资分析平台。

立即接入：https://t.me/stocktvpaopao
官方文档：https://documenter.getpostman.com/view/42914868/2sB2ixkEZR