印度股票实时数据市场API对接

概述

StockTV API提供全面的印度股票市场数据接口，支持实时行情、历史数据、指数信息、公司详情等功能。所有接口均返回JSON格式数据。

准备工作

1. 获取API密钥

联系StockTV团队获取专属API Key
联系方式：Telegram

2. 基础配置

所有API请求都需要在URL参数中添加 key=您的API密钥
基础URL：https://api.stocktv.top
支持HTTP和WebSocket两种接入方式

印度股票市场接口

1. 股票市场列表

获取印度股票市场的股票列表，支持分页查询。

接口地址：GET /stock/stocks

请求参数：

参数名	必填	说明	示例值
countryId	是	国家ID，印度为14	14
pageSize	否	每页显示数量，默认10	10
page	否	页码，默认1	1
exchangeId	否	交易所ID（NSE:46, BSE:74）	46
key	是	API密钥	您的密钥

示例请求：

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

响应字段说明：

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 41602,                     // 股票PID
        "name": "Media Chinese Int",     // 股票名称
        "symbol": "MDCH",                // 股票代码
        "last": 0.12,                    // 最新价
        "chg": 0,                        // 涨跌额
        "chgPct": 0,                     // 涨跌百分比
        "high": 0.12,                    // 最高价
        "low": 0.12,                     // 最低价
        "volume": 1241700,               // 成交量
        "avgVolume": 441318,             // 平均交易量
        "exchangeId": 62,                // 交易所ID
        "countryId": 42,                 // 国家ID
        "countryNameTranslated": "India", // 国家名称
        "flag": "IN",                    // 国家代码
        "open": false,                   // 是否开市
        "lastClose": 0.12,               // 前收盘价
        "pairType": "Equities",          // 交易对类型
        "time": 1716448222               // 时间戳
      }
    ],
    "total": 1000,
    "size": 10,
    "current": 1,
    "pages": 500
  }
}

2. 查询单个股票

根据股票PID、名称或代码查询单个股票详情。

接口地址：GET /stock/queryStocks

请求参数：

参数名	必填	说明	示例值
id	否	股票PID	7310
name	否	股票名称	"Tata Motors"
symbol	否	股票代码	"TATAMOTORS"
key	是	API密钥	您的密钥

示例请求：

https://api.stocktv.top/stock/queryStocks?id=7310&key=您的密钥

3. 批量查询股票

根据多个股票PID批量查询股票信息。

接口地址：GET /stock/stocksByPids

请求参数：

参数名	必填	说明	示例值
pids	是	股票PID列表，用逗号分隔	"7310,17976"
key	是	API密钥	您的密钥

示例请求：

https://api.stocktv.top/stock/stocksByPids?pids=7310,17976&key=您的密钥

4. 股票指数

获取印度主要股票指数信息。

接口地址：GET /stock/indices

请求参数：

参数名	必填	说明	示例值
countryId	是	国家ID，印度为14	14
flag	否	国家代码	"IN"
key	是	API密钥	您的密钥

示例请求：

https://api.stocktv.top/stock/indices?countryId=14&key=您的密钥

响应示例：

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 17940,               // 指数PID
      "name": "Nifty 50",        // 指数名称
      "symbol": "NSEI",          // 指数代码
      "last": 22967.65,          // 最新价格
      "high": 22993.6,           // 最高价
      "low": 22577.45,           // 最低价
      "chg": 369.85,             // 涨跌额
      "chgPct": 1.64,            // 涨跌百分比
      "isOpen": false,           // 是否开盘
      "flag": "IN",              // 所属国家
      "time": 1716458537         // 时间戳
    }
  ]
}

5. 通过ID查询指数

根据指数PID查询特定指数信息。

接口地址：GET /stock/indicesById

请求参数：

参数名	必填	说明	示例值
id	是	指数PID	17940
key	是	API密钥	您的密钥

示例请求：

https://api.stocktv.top/stock/indicesById?id=17940&key=您的密钥

6. K线数据

获取股票的历史K线数据。

接口地址：GET /stock/kline

请求参数：

参数名	必填	说明	示例值	可选值
pid	是	股票PID	7310	-
interval	是	时间间隔	"PT15M"	PT5M, PT15M, PT1H, PT5H, P1D, P1W, P1M
key	是	API密钥	您的密钥	-

时间间隔说明：

PT5M: 5分钟
PT15M: 15分钟
PT1H: 1小时
PT5H: 5小时
P1D: 1天
P1W: 1周
P1M: 1月

示例请求：

https://api.stocktv.top/stock/kline?pid=7310&interval=PT15M&key=您的密钥

响应示例：

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "time": 1719818400000,     // 时间戳
      "open": 239.42,            // 开盘价
      "high": 239.6,             // 最高价
      "low": 239.42,             // 最低价
      "close": 239.6,            // 收盘价
      "volume": 0,               // 成交量
      "vo": 0                    // 成交额
    }
  ]
}

7. IPO新股日历

获取印度市场的IPO信息。

接口地址：GET /stock/getIpo

请求参数：

参数名	必填	说明	示例值	可选值
countryId	是	国家ID，印度为14	14	-
type	否	IPO类型	1	1:未上市, 2:已上市
key	是	API密钥	您的密钥	-

示例请求：

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

响应字段说明：

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 19,
      "ipoListing": 1724112000,          // 上市时间戳
      "country": "India",                // 国家
      "company": "Saraswati Saree Depot Ltd(SARW)", // 公司名称
      "exchange": "NSE",                 // 交易所
      "ipoValue": "1.6B",                // 发行市值
      "ipoPrice": "160.00",              // 发行价格
      "last": "158.23",                  // 最新价
      "symbol": "SARW",                  // 股票代码
      "date": "2024-08-20",              // 日期
      "pid": 1218991                     // 股票PID
    }
  ]
}

8. 涨跌排行榜

获取印度市场的涨幅榜、跌幅榜、涨停榜、跌停榜。

接口地址：GET /stock/updownList

请求参数：

参数名	必填	说明	示例值	可选值
countryId	是	国家ID，印度为14	14	-
type	是	榜单类型	1	1:涨幅榜, 2:跌幅榜, 3:涨停榜, 4:跌停榜
key	是	API密钥	您的密钥	-

示例请求：

https://api.stocktv.top/stock/updownList?countryId=14&type=1&key=您的密钥

9. 公司信息

获取印度上市公司的详细信息。

接口地址：GET /stock/companies

请求参数：

参数名	必填	说明	示例值
countryId	是	国家ID，印度为14	14
pageSize	否	每页数量，默认10	10
page	否	页码，默认1	1
key	是	API密钥	您的密钥

示例请求：

https://api.stocktv.top/stock/companies?countryId=14&pageSize=10&page=1&key=您的密钥

响应字段说明：

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "companyName": "Aditya Birla Capital Ltd Company Profile", // 公司名称
        "description": "公司描述...",                               // 公司描述
        "industry": "Insurance",                                    // 所属行业
        "sector": "Financials",                                     // 所属板块
        "employeeCount": 34681,                                     // 员工人数
        "market": "India",                                          // 市场
        "countryId": 14,                                            // 国家ID
        "url": "/equities/aditya-birla",                           // 公司URL
        "id": 101                                                   // 公司ID
      }
    ],
    "total": 6838,
    "size": 10,
    "current": 1,
    "pages": 684
  }
}

10. 通过URL查询公司信息

根据股票详情页URL查询公司信息。

接口地址：GET /stock/companyUrl

请求参数：

参数名	必填	说明	示例值
url	是	股票详情页URL	"/equities/aditya-birla"
key	是	API密钥	您的密钥

示例请求：

https://api.stocktv.top/stock/companyUrl?url=/equities/aditya-birla&key=您的密钥

11. 国际新闻

获取国际金融新闻，可筛选印度相关新闻。

接口地址：GET /stock/news

请求参数：

参数名	必填	说明	示例值
pageSize	否	每页数量，默认10	10
page	否	页码，默认1	1
type	否	新闻类型，默认2	2
key	是	API密钥	您的密钥

示例请求：

https://api.stocktv.top/stock/news?pageSize=10&page=1&key=您的密钥

12. WebSocket实时推送

获取股票的实时行情数据推送。

连接地址：

wss://ws-api.stocktv.top/connect?key=您的密钥

连接成功后：

需要定时发送心跳保持连接
订阅股票PID列表

前端示例代码：

const wsUri = "wss://ws-api.stocktv.top/connect?key=您的密钥";
const websocket = new WebSocket(wsUri);

websocket.onopen = function(event) {
    console.log("Connected to WebSocket server");
};

websocket.onmessage = function(event) {
    const data = JSON.parse(event.data);
    console.log("Received:", data);
};

websocket.onclose = function(event) {
    console.log("Disconnected from WebSocket server");
};

WebSocket返回字段说明：

{
  "ask": "0.680",              // 卖单价
  "bid": "0.675",              // 买单价
  "high": "0.680",             // 最高价
  "last_close": "0.680",       // 前收盘价
  "last_dir": "greenBg",       // 最后交易方向
  "last_numeric": "0.68",      // 最新成交价
  "low": "0.650",              // 最低价
  "pc": "0.000",               // 涨跌额
  "pcp": "0.00",               // 涨跌幅
  "pid": "992844",             // 产品PID
  "time": "02:44:11",          // 交易时间
  "timestamp": "1717728251",   // 时间戳
  "turnover_numeric": "3672800", // 成交额
  "type": 1                    // 类型: 1股票, 2指数
}

交易所ID对照表

交易所	交易所ID	说明
NSE	46	印度国家证券交易所
BSE	74	孟买证券交易所
NYSE	1	纽约证券交易所
NASDAQ	2	纳斯达克交易所
上海交易所	54	上海证券交易所
深圳交易所	103	深圳证券交易所

错误处理

所有接口返回统一的JSON格式：

{
  "code": 200,        // 状态码：200成功，其他为错误
  "message": "操作成功", // 状态描述
  "data": {}          // 返回数据
}

注意事项

API密钥：所有请求必须包含有效的API密钥
频率限制：注意接口调用频率，避免触发限流
数据更新：实时数据有轻微延迟，约1-3秒
时区处理：所有时间戳为Unix时间戳（秒级），时区为UTC
免费支持：StockTV提供免费技术支持，协助对接

技术支持

如需帮助或获取API密钥，请联系官方：

Telegram
提供免费技术支持和对接协助

这份文档涵盖了印度股票市场的主要API接口，包括实时行情、历史数据、指数信息、公司详情等功能。根据您的具体需求，可以选择相应的接口进行对接。如有特定功能需求或技术问题，可随时联系StockTV技术支持团队。

posted @ 2026-04-18 19:17 StockTV 阅读(11) 评论(0) 收藏举报

刷新页面返回顶部

stocktv

印度股票实时数据市场API对接

概述

准备工作

1. 获取API密钥

2. 基础配置

印度股票市场接口

1. 股票市场列表

2. 查询单个股票

3. 批量查询股票

4. 股票指数

5. 通过ID查询指数

6. K线数据

7. IPO新股日历

8. 涨跌排行榜

9. 公司信息

10. 通过URL查询公司信息

11. 国际新闻

12. WebSocket实时推送

交易所ID对照表

错误处理

注意事项

技术支持

公告