印度股票市场API对接文档

一、概述

StockTV提供全球股票、外汇、期货及加密货币的实时行情数据接口，支持印度、美国、日本、东南亚等多国市场。本文档重点介绍印度股票市场的API对接流程，包含市场列表、指数、K线、IPO数据、实时行情等核心功能。
二、准备工作

1. 获取API Key

• 联系StockTV官方获取API Key：Telegram联系。
  
• 所有接口需在请求参数中添加 key=您的API Key。
  

2. 数据格式

• 所有接口返回均为JSON格式。
  
• 支持HTTP和WebSocket两种接入方式。
  

三、核心接口说明（印度市场）

1. 获取印度股票市场列表

接口地址
GET /stock/stocks
请求参数
参数必填说明示例值countryId是国家ID（印度为14）14pageSize否每页数量（默认10）10page否页码（默认1）1示例请求

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

复制代码

响应示例

1. {
2.   "code": 200,
3.   "message": "操作成功",
4.   "data": {
5.     "records": [
6.       {
7.         "id": 41602,          // 股票唯一PID
8.         "symbol": "MDCH",     // 股票代码
9.         "name": "Media Chinese Int", // 股票名称
10.         "last": 0.12,         // 最新价
11.         "chgPct": 0,          // 涨跌幅
12.         "volume": 1241700,    // 成交量
13.         "countryId": 14,      // 国家ID（14=印度）
14.         "open": false         // 是否开市（true/false）
15.       },
16.       ...
17.     ],
18.     "total": 1000             // 总记录数
19.   }
20. }

复制代码

2. 查询印度股票指数（如Nifty 50）

接口地址
GET /stock/indices
请求参数
参数必填说明示例值countryId是国家ID（印度为14）14示例请求

1. GET https://api.stocktv.top/stock/indices?countryId=14&key=您的APIKey

复制代码

响应示例

1. {
2.   "code": 200,
3.   "message": "操作成功",
4.   "data": [
5.     {
6.       "id": 17940,
7.       "name": "Nifty 50",      // 指数名称
8.       "symbol": "NSEI",        // 指数代码
9.       "last": 22967.65,        // 最新价格
10.       "chgPct": 1.64,          // 涨跌幅
11.       "isOpen": false           // 是否开盘
12.     },
13.     ...
14.   ]
15. }

复制代码

3. 获取股票K线数据

接口地址
GET /stock/kline
请求参数
参数必填说明示例值pid是股票PID（从市场列表接口获取）7310interval是时间间隔（PT15M=15分钟，P1D=日线）PT15M示例请求

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

复制代码

响应示例

1. {
2.   "code": 200,
3.   "data": [
4.     {
5.       "time": 1719818400000,    // 时间戳
6.       "open": 239.42,           // 开盘价
7.       "high": 239.6,            // 最高价
8.       "low": 239.42,            // 最低价
9.       "close": 239.6,           // 收盘价
10.       "volume": 0               // 成交量
11.     },
12.     ...
13.   ]
14. }

复制代码

4. 印度IPO新股日历

接口地址
GET /stock/getIpo
请求参数
参数必填说明示例值countryId是国家ID（印度为14）14type否类型（1=未上市，2=已上市）1示例请求

1. GET https://api.stocktv.top/stock/getIpo?countryId=14&type=1&key=您的APIKey

复制代码

响应示例

1. {
2.   "code": 200,
3.   "data": [
4.     {
5.       "company": "Saraswati Saree Depot Ltd(SARW)", // 公司名称
6.       "exchange": "NSE",          // 交易所
7.       "ipoPrice": "160.00",       // 发行价
8.       "ipoListing": 1724112000,   // 上市时间戳
9.       "symbol": "SARW"            // 股票代码
10.     },
11.     ...
12.   ]
13. }

复制代码

5. 实时行情WebSocket

连接地址
wss://ws-api.stocktv.top/connect?key=您的APIKey
功能说明

• 连接后发送心跳包保持连接。
  
• 实时推送股票价格、成交量、涨跌幅等数据。
  

订阅消息格式

1. {
2.   "pid": "7310",      // 股票PID
3.   "last": 239.6,      // 最新价
4.   "chgPct": "+0.15%", // 涨跌幅
5.   "volume": 1241700   // 成交量
6. }

复制代码

Java示例代码

1. // 参考官方Demo：https://github.com/CryptoRzz/stocktv-ws-demo

复制代码

四、注意事项

• 频率限制：默认每秒10次请求，高频需联系官方调整。
  
• 时区：所有时间戳为UTC时间，需转换为印度时区（IST, UTC+5:30）。
  
• 错误码：常见错误码如 401（Key无效）、429（频率超限）。
  

五、对接流程

• 获取API Key：联系StockTV官方。
  
• 测试接口：使用Postman集合调试。
  
• 集成开发：按需调用市场列表、K线、实时推送接口。
  
• 生产环境：切换至正式域名，监控API稳定性。
  

六、技术支持

• 官方文档：StockTV API文档
  
• 联系客服：Telegram支持
  

通过以上接口，开发者可快速接入印度股票市场的实时行情、历史数据及IPO信息，适用于金融分析、量化交易等场景。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！