印度实时股票数据源接口对接文档-IPO新股、k线数据

概述

StockTV 提供全面的印度股票市场数据接口，覆盖印度国家证券交易所（NSE）和孟买证券交易所（BSE）所有上市公司。支持实时行情、技术分析、公司信息、IPO数据等多种功能。

基础信息

基础URL : https://api.stocktv.top
WebSocket URL : wss://ws-api.stocktv.top/connect
数据格式: JSON
印度国家ID : 14
交易所ID :
- NSE: 46
- BSE: 74

快速开始

1. 获取 API Key

请联系官方获取有效的 API Key，所有接口调用都需要在参数中携带 key。

2. 基础请求示例

http 复制代码

GET /stock/stocks?countryId=14&pageSize=10&page=1&key=您的API_KEY

核心功能接口

1. 股票市场列表

获取印度股票列表

http 复制代码

GET /stock/stocks?countryId=14&pageSize=50&page=1&key=您的API_KEY

参数说明:

countryId: 国家ID，印度为14
pageSize: 每页显示数量，默认10
page: 页码，默认1
exchangeId: 交易所ID（可选：46-NSE, 74-BSE）

响应示例:

json 复制代码

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 7310,
        "symbol": "RELIANCE",
        "name": "Reliance Industries Ltd",
        "last": 2456.75,
        "chg": 12.50,
        "chgPct": 0.51,
        "high": 2468.20,
        "low": 2442.10,
        "volume": 4521890,
        "open": false,
        "exchangeId": 46,
        "countryId": 14,
        "countryNameTranslated": "India",
        "flag": "IN",
        "fundamentalMarketCap": 16500000000000,
        "fundamentalRevenue": "8.3T",
        "technicalDay": "buy",
        "performanceDay": 0.51,
        "performanceWeek": 2.15,
        "performanceMonth": 5.32,
        "time": 1716448222,
        "url": "/equities/reliance-industries-ltd"
      }
    ],
    "total": 5000,
    "size": 50,
    "current": 1,
    "pages": 100
  }
}

2. 个股查询

查询单个股票

http 复制代码

GET /stock/queryStocks?id=7310&key=您的API_KEY

查询参数（可单独或组合使用）:

id: 股票PID
symbol: 股票代码
name: 股票名称
url: 详情页链接

批量查询多个股票

http 复制代码

GET /stock/stocksByPids?key=您的API_KEY&pids=7310,17976,8923

热门印度股票代码:

RELIANCE: Reliance Industries
TCS: Tata Consultancy Services
HDFCBANK: HDFC Bank
INFY: Infosys
HINDUNILVR: Hindustan Unilever
ITC: ITC Limited
SBIN: State Bank of India

3. 指数数据

获取印度主要指数

http 复制代码

GET /stock/indices?countryId=14&key=您的API_KEY

包含的主要指数:

Nifty 50
Nifty Bank
BSE Sensex
Nifty IT
Nifty Pharma

响应示例:

json 复制代码

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 17940,
      "name": "Nifty 50",
      "symbol": "NSEI",
      "last": 22967.65,
      "chg": 369.85,
      "chgPct": 1.64,
      "high": 22993.6,
      "low": 22577.45,
      "isOpen": false,
      "flag": "IN",
      "url": "/indices/s-p-cnx-nifty",
      "time": 1716458537
    }
  ]
}

通过ID查询特定指数

http 复制代码

GET /stock/indicesById?id=17940&key=您的API_KEY

4. K线数据

获取股票K线数据

http 复制代码

GET /stock/kline?pid=7310&interval=PT15M&key=您的API_KEY

时间间隔参数:

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

响应示例:

json 复制代码

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "time": 1719818400000,
      "open": 239.42,
      "high": 239.6,
      "low": 239.42,
      "close": 239.6,
      "volume": 0,
      "vo": 0
    }
  ]
}

5. IPO新股日历

获取印度IPO信息

http 复制代码

GET /stock/getIpo?key=您的API_KEY&countryId=14&type=1

参数说明:

type: 1-未上市, 2-已上市

响应示例:

json 复制代码

{
  "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",
      "url": "/equities/saraswati-saree-depot",
      "date": "2024-08-20",
      "pid": 1218991
    }
  ]
}

6. 涨跌排行榜

获取印度市场排行榜

http 复制代码

GET /stock/updownList?countryId=14&type=1&key=您的API_KEY

排行榜类型:

type=1: 涨幅榜
type=2: 跌幅榜
type=3: 涨停榜
type=4: 跌停榜

7. 公司信息

获取印度上市公司列表

http 复制代码

GET /stock/companies?countryId=14&pageSize=20&page=1&key=您的API_KEY

通过URL查询详细公司信息

http 复制代码

GET /stock/companyUrl?url=/equities/reliance-industries&key=您的API_KEY

响应示例:

json 复制代码

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "companyName": "Reliance Industries Ltd Company Profile",
    "description": "Reliance Industries Limited is engaged in hydrocarbon exploration and production, petroleum refining and marketing, petrochemicals, retail, and digital services...",
    "industry": "Oil & Gas",
    "sector": "Energy",
    "employeeCount": 236820,
    "market": "India",
    "countryId": 14,
    "url": "/equities/reliance-industries-ltd",
    "id": 101
  }
}

8. 新闻数据

获取国际新闻（包含印度相关）

http 复制代码

GET /stock/news?pageSize=10&page=1&key=您的API_KEY&type=2

WebSocket 实时数据

连接WebSocket服务器

javascript 复制代码

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

WebSocket数据格式

json 复制代码

{
  "pid": "7310",
  "last_numeric": "2456.75",
  "bid": "2456.50",
  "ask": "2457.00",
  "high": "2468.20",
  "low": "2442.10",
  "last_close": "2444.25",
  "pc": "12.50",
  "pcp": "0.51",
  "pc_col": "greenFont",
  "turnover_numeric": "4521890",
  "time": "15:30:25",
  "timestamp": "1717728251",
  "type": 1
}

WebSocket字段说明

pid: 产品ID
last_numeric: 最新价格
bid: 买入价
ask: 卖出价
high: 最高价
low: 最低价
last_close: 前收盘价
pc: 价格变化
pcp: 涨跌幅百分比
pc_col: 价格变化颜色
turnover_numeric: 成交量
time: 交易时间
timestamp: 时间戳
type: 类型（1-股票, 2-指数）

技术指标数据

技术分析指标

股票数据中包含以下技术指标：

技术指标字段:

technicalDay: 日线技术指标
technicalHour: 小时线技术指标
technicalWeek: 周线技术指标
technicalMonth: 月线技术指标

技术指标值:

strong_buy: 强烈买入
buy: 买入
neutral: 中性
sell: 卖出
strong_sell: 强烈卖出

基本面数据

财务指标

fundamentalBeta: Beta值
fundamentalMarketCap: 市值
fundamentalRevenue: 收入
fundamentalRatio: 基本面比率

业绩表现

performanceDay: 当日表现
performanceWeek: 周表现
performanceMonth: 月表现
performanceYear: 年度表现
performanceYtd: 年初至今表现
performance3Year: 3年表现

使用示例

获取Nifty 50成分股

http 复制代码

GET /stock/stocks?countryId=14&pageSize=50&key=您的API_KEY

查询Reliance Industries

http 复制代码

GET /stock/queryStocks?symbol=RELIANCE&key=您的API_KEY

获取实时指数

http 复制代码

GET /stock/indices?countryId=14&key=您的API_KEY

批量查询银行股

http 复制代码

GET /stock/stocksByPids?key=您的API_KEY&pids=7310,17976,8923,11567,12894

获取日K线数据

http 复制代码

GET /stock/kline?pid=7310&interval=P1D&key=您的API_KEY

数据字段详细说明

股票数据字段

字段名	说明	数据类型
id	股票PID	Long
symbol	股票代码	String
name	股票名称	String
last	最新价格	BigDecimal
chg	涨跌额	BigDecimal
chgPct	涨跌幅百分比	BigDecimal
high	最高价	BigDecimal
low	最低价	BigDecimal
volume	成交量	Long
open	是否开市	Boolean
exchangeId	交易所ID	Integer
countryId	国家ID	Integer
time	时间戳	Long
fundamentalMarketCap	市值	BigDecimal
fundamentalRevenue	收入	String
technicalDay	日线技术指标	String

K线数据字段

字段名	说明	数据类型
time	时间戳	Long
open	开盘价	BigDecimal
high	最高价	BigDecimal
low	最低价	BigDecimal
close	收盘价	BigDecimal
volume	成交量	Long
vo	成交额	BigDecimal

错误处理

错误响应格式

json 复制代码

{
  "code": 400,
  "message": "参数错误",
  "data": null
}

常见错误代码

200: 操作成功
400: 参数错误
401: API Key无效
404: 数据不存在
500: 服务器内部错误

最佳实践

1. 批量数据获取

使用 stocksByPids 接口批量获取数据，减少API调用次数。

2. 实时数据监控

对于实时性要求高的场景，使用WebSocket连接。

3. 缓存策略

对公司信息等不经常变化的数据实施缓存。

4. 错误处理

实现适当的错误重试机制。

5. 频率控制

注意API调用频率限制，避免过度请求。

注意事项

交易时间

NSE/BSE: 印度时间 09:15-15:30
时区: IST (UTC+5:30)

货币单位

所有价格均为印度卢比 (INR)。