印度股票市场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

---

四、注意事项

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

---

五、对接流程

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

---

六、技术支持

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

---

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