印度实时股票数据源接口对接文档-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. 基础请求示例

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

核心功能接口

1. 股票市场列表

获取印度股票列表

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）

响应示例:

{
  "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. 个股查询

查询单个股票

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

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

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

批量查询多个股票

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. 指数数据

获取印度主要指数

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

包含的主要指数:

  • Nifty 50
  • Nifty Bank
  • BSE Sensex
  • Nifty IT
  • Nifty Pharma

响应示例:

{
  "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查询特定指数

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

4. K线数据

获取股票K线数据

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

时间间隔参数:

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

响应示例:

{
  "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信息

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

参数说明:

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

响应示例:

{
  "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. 涨跌排行榜

获取印度市场排行榜

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

排行榜类型:

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

7. 公司信息

获取印度上市公司列表

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

通过URL查询详细公司信息

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

响应示例:

{
  "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. 新闻数据

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

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

WebSocket 实时数据

连接WebSocket服务器

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

WebSocket数据格式

{
  "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成分股

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

查询Reliance Industries

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

获取实时指数

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

批量查询银行股

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

获取日K线数据

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

错误处理

错误响应格式

{
  "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)。

posted @ 2025-10-31 18:07  CryptoRzz  阅读(4)  评论(0)    收藏  举报