杓疠? 发表于 2025-5-31 23:37:00

印度股票市场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示例请求
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(从市场列表接口获取)7310interval是时间间隔(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)14type否类型(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信息,适用于金融分析、量化交易等场景。

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: 印度股票市场API对接文档