印度股票API对接的技术博客

---

印度股票市场API对接指南：实时数据、历史K线与指数行情

本文基于stocktv.top的全球股票API，重点解析印度股票市场（国家ID=14）

---

核心接口与使用场景

1. 市场列表接口
   获取印度交易所全部股票清单（NSE/BSE）：

   GET /stock/stocks?countryId=14&pageSize=100&page=1&key=YOUR_KEY
   

   关键参数：

   • countryId=14（印度国家标识）
   • pageSize：分页大小（默认10）
   • 返回字段包含：股票代码（symbol）、名称（name）、实时价格（last）、涨跌幅（chgPct）、成交量（volume）

2. 指数行情接口
   获取Nifty 50、Sensex等指数实时数据：

   GET /stock/indices?countryId=14&key=YOUR_KEY
   

   响应示例：

   {
     "id": 17940,
     "name": "Nifty 50",
     "symbol": "NSEI",
     "last": 22967.65,
     "chgPct": 1.64,
     "isOpen": false // 是否交易中
   }
   

3. 历史K线数据
   支持分钟级到月线数据：

   GET /stock/kline?pid=7310&interval=PT15M&key=YOUR_KEY
   

   时间间隔参数：

   • PT5M（5分钟）| PT1H（1小时）| P1D（日线）
   • K线结构：开盘价（open）、最高价（high）、成交量（volume）、时间戳（time）

4. 实时推送（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.symbol} 最新价: ${data.last_numeric}`);
   };
   

   推字段说明：

   • last_numeric：最新价
   • pcp：涨跌幅百分比
   • type=1（股票）或2（指数）

5. 特色数据接口

   • IPO新股日历：GET /stock/getIpo?countryId=14
   • 涨跌榜：GET /stock/updownList?countryId=14&type=1（1=涨幅榜）
   • 公司基本面：GET /stock/companies?countryId=14

---

使用示例：获取Reliance Industries行情

import requests

api_url = "https://api.stocktv.top/stock/queryStocks"
params = {
    "symbol": "RELIANCE", 
    "countryId": 14,
    "key": "YOUR_KEY"
}

response = requests.get(api_url, params=params)
stock_data = response.json()["data"][0]

print(f"""
  股票名称: {stock_data["name"]}
  当前价格: {stock_data["last"]}
  日涨跌幅: {stock_data["chgPct"]}%
  成交量: {stock_data["volume"]:,}
""")

---

最佳实践建议

1. 缓存机制：对指数、公司信息等低频数据做本地缓存
2. 限流处理：遵守API每秒请求限制（未明确时建议<10次/秒）
3. 错误码处理：
   • 200：成功
   • 4xx：参数错误（检查countryId或pid）
   • 5xx：服务端异常（建议重试机制）
4. 实时性优化：WebSocket连接需每30秒发送心跳包维持连接

---

典型应用场景

✅ 投资组合监控仪表盘
✅ 手机端实时行情推送
✅ 量化交易策略回测（历史K线）
✅ IPO新股申购提醒系统
✅ 上市公司基本面分析工具

注：所有接口需替换YOUR_KEY为实际API密钥（通过官方渠道申请），完整文档见https://documenter.getpostman.com/view/42914868/2sB2ixkEZR。

---