印度股票市场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） | 14 |
pageSize | 否 | 每页数量（默认10） | 10 |
page | 否 | 页码（默认1） | 1 |
示例请求
GET https://api.stocktv.top/stock/stocks?countryId=14&pageSize=10&page=1&key=您的APIKey
响应示例
{"code": 200,"message": "操作成功","data": {"records": [{"id": 41602, // 股票唯一PID"symbol": "MDCH", // 股票代码"name": "Media Chinese Int", // 股票名称"last": 0.12, // 最新价"chgPct": 0, // 涨跌幅"volume": 1241700, // 成交量"countryId": 14, // 国家ID（14=印度）"open": false // 是否开市（true/false）},...],"total": 1000 // 总记录数}
}
2. 查询印度股票指数（如Nifty 50）
接口地址
GET /stock/indices
请求参数
| 参数 | 必填 | 说明 | 示例值 |
|---|---|---|---|
countryId | 是 | 国家ID（印度为14） | 14 |
示例请求
GET https://api.stocktv.top/stock/indices?countryId=14&key=您的APIKey
响应示例
{"code": 200,"message": "操作成功","data": [{"id": 17940,"name": "Nifty 50", // 指数名称"symbol": "NSEI", // 指数代码"last": 22967.65, // 最新价格"chgPct": 1.64, // 涨跌幅"isOpen": false // 是否开盘},...]
}
3. 获取股票K线数据
接口地址
GET /stock/kline
请求参数
| 参数 | 必填 | 说明 | 示例值 |
|---|---|---|---|
pid | 是 | 股票PID（从市场列表接口获取） | 7310 |
interval | 是 | 时间间隔（PT15M=15分钟，P1D=日线） | PT15M |
示例请求
GET https://api.stocktv.top/stock/kline?pid=7310&interval=PT15M&key=您的APIKey
响应示例
{"code": 200,"data": [{"time": 1719818400000, // 时间戳"open": 239.42, // 开盘价"high": 239.6, // 最高价"low": 239.42, // 最低价"close": 239.6, // 收盘价"volume": 0 // 成交量},...]
}
4. 印度IPO新股日历
接口地址
GET /stock/getIpo
请求参数
| 参数 | 必填 | 说明 | 示例值 |
|---|---|---|---|
countryId | 是 | 国家ID（印度为14） | 14 |
type | 否 | 类型（1=未上市，2=已上市） | 1 |
示例请求
GET https://api.stocktv.top/stock/getIpo?countryId=14&type=1&key=您的APIKey
响应示例
{"code": 200,"data": [{"company": "Saraswati Saree Depot Ltd(SARW)", // 公司名称"exchange": "NSE", // 交易所"ipoPrice": "160.00", // 发行价"ipoListing": 1724112000, // 上市时间戳"symbol": "SARW" // 股票代码},...]
}
5. 实时行情WebSocket
连接地址
wss://ws-api.stocktv.top/connect?key=您的APIKey
功能说明
- 连接后发送心跳包保持连接。
- 实时推送股票价格、成交量、涨跌幅等数据。
订阅消息格式
{"pid": "7310", // 股票PID"last": 239.6, // 最新价"chgPct": "+0.15%", // 涨跌幅"volume": 1241700 // 成交量
}
Java示例代码
// 参考官方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信息，适用于金融分析、量化交易等场景。