当前位置： 首页 > news >正文

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

news 2026/5/11 1:11:13

引言

本API专为开发者提供印度股票市场的实时及历史数据接入能力，覆盖印度国家证券交易所（NSE）、孟买证券交易所（BSE）等核心交易场所的股票行情、指数数据、K线信息、IPO日历、涨跌排行榜等全维度数据。接口支持HTTP（RESTful）和WebSocket两种接入方式，返回标准JSON格式数据，可广泛应用于金融数据分析、行情展示、交易辅助等场景，满足各类开发者对印度股票市场数据的集成需求。

1. 核心特性与优势

1.1 极低延迟的实时数据流

  • 数据同步机制：与印度NSE/BSE交易所行情系统直连，数据更新与交易所同步，实时行情数据端到端延迟≤500ms；
  • 时间戳精度：行情数据时间戳精准到秒级，K线数据时间戳精准到毫秒级，确保数据时效性与可追溯性；
  • 高频更新能力：最小粒度支持1分钟级K线数据更新，实时行情字段（最新价、成交量、涨跌幅等）秒级刷新，满足高频交易场景的数据需求。

1.2 高可用与稳健的服务架构

  • 容灾架构：采用多节点集群部署+异地容灾设计，单个节点故障可自动切换，避免单点失效；
  • 服务可用性：承诺99.9%的年度服务可用性（SLA），全年计划外中断时长不超过8.76小时；
  • 监控与告警：建立全链路监控体系，实时监控接口响应时长、数据同步状态、服务器负载等指标，异常状态秒级触发告警，技术团队7×24小时响应故障；
  • 数据一致性：与交易所原始数据的偏差率低于0.01%，历史运行无重大数据失真或服务中断记录。

1.3 数据全面性与覆盖范围

  • 交易所覆盖：完整覆盖印度两大核心交易所（NSE、BSE）的全量股票品种；
  • 数据类型覆盖：
    • 基础行情：个股实时成交价、涨跌幅、成交量、高低价、市值等核心指标；
    • 指数数据：Nifty 50等印度主流指数的实时行情、涨跌额、开盘状态等；
    • 历史数据：5分钟/15分钟/1小时/5小时/日/周/月级K线数据；
    • 特色数据：IPO新股日历（未上市/已上市）、股票涨跌排行榜（涨幅/跌幅/涨停/跌停）、公司基本面信息（Beta值、营收、市值等）；
  • 维度丰富性：支持股票3年/日/月/周/年/年初至今的业绩数据、日线/小时线/月线/周线技术指标（strong_buy/strong_sell/neutral等）。

1.4 开发者友好

  • 接口设计：遵循RESTful规范，参数与响应字段注释清晰，降低解析成本；
  • 接入成本：无需复杂的前置配置，HTTP接口无额外依赖，WebSocket接口兼容主流语言客户端库；
  • 技术支持：提供免费的全程技术辅助对接，解答集成过程中的各类问题；
  • 灵活性：支持单只/多只股票批量查询、分页查询等模式，适配不同业务场景的需求。

2. 接口详情

2.1 基础信息

  • 基础URL：https://api.stocktv.top
  • WebSocket基础地址：wss://api.stocktv.top/ws/stock
  • 认证方式：API Key认证（所有请求需在Query参数中携带key字段，Key由服务商提供）；
  • 数据格式：所有HTTP接口响应均为UTF-8编码的JSON格式；WebSocket推送数据为JSON字符串；
  • 请求方法：HTTP接口均为GET方法，无需POST/PUT/DELETE等复杂操作。

2.2 实时行情接口（单只股票查询）

接口路径

/stock/queryStocks

请求参数
参数名类型必填描述示例值
id字符串否股票唯一PID7310
name字符串否股票名称（模糊匹配）Media Chinese Int
symbol字符串否股票代码MDCH
key字符串是接口认证Key联系服务商获取
响应示例
{"code":200,"message":"操作成功","data":[{"id":41602,"avgVolume":441318,"chg":0,"chgPct":0,"countryNameTranslated":"India","exchangeId":46,"flag":"IN","fundamentalBeta":0.627,"fundamentalMarketCap":202470000,"fundamentalRatio":-5.1,"fundamentalRevenue":"145.22M","high":0.12,"last":0.12,"lastPairDecimal":3,"low":0.12,"name":"Media Chinese Int","pairType":"Equities","performance3Year":-29.41,"performanceDay":0,"performanceMonth":0,"performanceWeek":-4,"performanceYear":-25,"performanceYtd":-11.11,"symbol":"MDCH","technicalDay":"strong_sell","technicalHour":"strong_sell","technicalMonth":"strong_sell","technicalWeek":"strong_sell","time":1716448222,"url":"/equities/media-chinese-international-ltd","volume":1241700,"countryId":14,"open":false,"cfd":false,"lastClose":0.12}]}
响应字段说明
字段名描述
code响应状态码（200为成功）
message响应信息
data.id股票唯一标识（PID）
data.last股票最新成交价
data.chgPct涨跌幅（百分比，需自行拼接%）
data.volume当日交易量
data.time数据更新时间戳（秒级）
data.exchangeId交易所ID（46=NSE，74=BSE）

2.3 历史数据接口（K线数据）

接口路径

/stock/kline

请求参数
参数名类型必填描述示例值
pid字符串是股票/指数唯一PID7310
interval字符串是K线粒度：PT5M(5分钟)/PT15M(15分钟)/PT1H(1小时)/PT5H(5小时)/P1D(1天)/P1W(1周)/P1M(1月)PT15M
key字符串是接口认证Key联系服务商获取
响应示例
{"code":200,"message":"操作成功","data":[{"time":1719818400000,"open":239.42,"high":239.6,"low":239.42,"close":239.6,"volume":0,"vo":0},{"time":1719818460000,"open":239.6,"high":239.6,"low":239.55,"close":239.55,"volume":0,"vo":0}]}

2.4 WebSocket推送接口（实时行情）

WebSocket接口用于订阅股票实时行情推送，避免高频轮询，降低服务端与客户端开销。

连接地址

wss://api.stocktv.top/ws/stock

连接参数
参数名类型必填描述示例值
key字符串是接口认证Key联系服务商获取
countryId字符串是国家ID（印度=14）14
pids字符串是订阅的股票PID列表（逗号分隔）41602,7310
推送数据示例
{"type":"stock_realtime","data":{"id":41602,"last":0.13,"chg":0.01,"chgPct":8.33,"volume":1500000,"time":1716448288}}
说明
  • 连接成功后，服务端会持续推送订阅股票的实时行情，推送频率与交易所同步（秒级）；
  • 若连接空闲超过5分钟，服务端会主动断开，建议客户端添加重连机制。

3. 接入流程

3.1 注册与获取密钥

  1. 联系服务商获取API Key（联系方式：https://t.me/CryptoRzz）；
  2. Key为唯一认证凭证，需妥善保管，避免泄露；
  3. 测试与生产环境共用一套Key，服务商可根据需求调整权限（如请求频率、订阅数量）。

3.2 环境准备

  • 网络环境：确保开发/生产环境可访问api.stocktv.top域名，无防火墙/代理限制；
  • 依赖准备：
    • HTTP接口：无需额外依赖，支持所有可发起HTTP GET请求的编程语言；
    • WebSocket接口：需使用对应语言的WS客户端库（如Python的websockets、Java的javax.websocket、JavaScript的WebSocket）。

3.3 调用示例（Python）

示例1：HTTP接口查询印度股票列表
importrequests# 配置信息BASE_URL="https://api.stocktv.top"API_KEY="你的API Key"defget_india_stock_list(page=1,page_size=10):"""查询印度股票市场列表（countryId=14）"""url=f"{BASE_URL}/stock/stocks"params={"countryId":14,"page":page,"pageSize":page_size,"key":API_KEY}try:response=requests.get(url,params=params,timeout=5)response.raise_for_status()# 抛出HTTP异常returnresponse.json()exceptrequests.exceptions.RequestExceptionase:print(f"请求异常：{e}")returnNone# 调用示例if__name__=="__main__":stock_list=get_india_stock_list(page=1,page_size=5)ifstock_list:print("印度股票列表：")forstockinstock_list["data"]["records"]:print(f"股票名称：{stock['name']}，代码：{stock['symbol']}，最新价：{stock['last']}")
示例2：WebSocket订阅实时行情
importasyncioimportwebsocketsimportjson API_KEY="你的API Key"WS_BASE_URL="wss://api.stocktv.top/ws/stock"asyncdefsubscribe_realtime(pids):"""订阅指定股票的实时行情"""# 构建连接参数params={"key":API_KEY,"countryId":14,"pids":",".join(pids)}# 拼接参数到WebSocket地址ws_url=f"{WS_BASE_URL}?{'&'.join([f'{k}={v}'fork,vinparams.items()])}"asyncwithwebsockets.connect(ws_url)aswebsocket:print("WebSocket连接成功，开始接收实时数据...")whileTrue:try:data=awaitwebsocket.recv()realtime_data=json.loads(data)print(f"实时行情更新：{realtime_data}")exceptwebsockets.exceptions.ConnectionClosed:print("连接断开，正在重连...")awaitasyncio.sleep(3)awaitsubscribe_realtime(pids)# 重连break# 启动订阅if__name__=="__main__":subscribe_pids=["41602","7310"]# 要订阅的股票PIDasyncio.run(subscribe_realtime(subscribe_pids))

4. 服务保障与限制

4.1 服务级别协议（SLA）说明

  • 可用性承诺：年度服务可用性≥99.9%，计划外中断时长≤8.76小时/年；
  • 故障响应：
    • 一般问题（如接口参数咨询）：1小时内响应，4小时内解决；
    • 重大故障（服务中断、数据失真）：10分钟内响应，优先恢复服务，24小时内提供故障根因分析；
  • 数据补偿：若因服务端问题导致数据缺失/延迟超出承诺范围，可根据实际影响时长延长Key有效期。

4.2 请求频率限制

接口类型单Key限制超出限制处理
HTTP接口每秒≤5次，每分钟≤200次返回429状态码，5分钟后恢复
WebSocket接口单连接订阅≤100个PID，单Key≤5个连接拒绝新连接/订阅，返回错误提示

4.3 数据更新频率说明

数据类型更新频率备注
个股实时行情秒级（≤500ms）与交易所行情同步
指数实时行情秒级（≤500ms）Nifty 50等核心指数优先更新
K线数据对应粒度结束后立即更新如15分钟K线每15分钟更新
IPO日历每日凌晨（印度时间）新增/更新IPO信息
涨跌排行榜秒级与实时行情同步刷新
公司基本面信息每日更新基于交易所披露数据

5. 常见问题（FAQ）

Q1：接口返回401状态码是什么原因？

A1：401表示认证失败，可能原因包括：① API Key错误；② Key已过期；③ 请求未携带key参数。请核对Key有效性，并确保所有请求的Query参数中包含key。

Q2：countryId和exchangeId的取值有哪些？

A2：印度的countryId固定为14；exchangeId核心取值：46（NSE）、74（BSE），其他交易所ID可联系服务商获取完整列表。

Q3：K线数据的time字段是毫秒级还是秒级？

A3：K线接口的time字段为毫秒级时间戳，股票行情接口的time字段为秒级时间戳，可通过datetime.fromtimestamp()（秒级）或datetime.fromtimestamp(time/1000)（毫秒级）转换为本地时间。

Q4：是否支持批量查询多只股票？

A4：支持，可调用/stock/stocksByPids接口，通过pids参数传入多个股票PID（逗号分隔），单次最多支持50个PID批量查询。

Q5：WebSocket连接频繁断开怎么办？

A5：常见原因：① 网络波动；② 订阅PID数量超出限制；③ 空闲超时（5分钟）。建议：① 添加自动重连机制；② 控制订阅PID数量在100以内；③ 定期发送心跳包（如每3分钟发送空消息）。

结语

本API以低延迟、高可用为核心优势，为开发者提供了一站式的印度股票市场数据接入方案，覆盖NSE/BSE交易所全维度数据，且具备开发者友好的接入体验。无论是金融行情展示、量化分析，还是交易辅助系统开发，均可通过本API快速集成印度股票市场数据。

如需获取更详细的接口字段说明、权限升级、定制化数据需求等信息，可联系服务商获取官方完整文档，或通过技术支持渠道获取实时的集成协助。

http://www.jsqmd.com/news/792755/

相关文章：

  • 基于 Simulink 的级联 H 桥（CHB）七电平逆变器载波移相调制实战教程
  • Cursor AI编程助手离线资源库部署与本地模型集成实战
  • 大语言模型自我优化：Self-Refine框架原理与工程实践
  • 3分钟快速找回Navicat数据库连接密码的完整指南
  • 开源营销技能图谱：构建个人与团队的数字化能力体系
  • 基于向量数据库与语义搜索构建个人知识库系统实践指南
  • 什么是悲观锁、乐观锁？
  • AI代码重构工具Refly：从原理到实战的开发者指南
  • 别再复制粘贴了！手把手教你从零搭建STM32F429 MDK5工程模板（附完整源码包）
  • Godot游戏开发快速启动：项目模板化与最佳实践指南
  • Taotoken的用量分析功能让团队资源消耗一目了然
  • Go语言开源工具conforme：配置驱动的数据一致性校验与清洗实战
  • Instrukt框架：构建生产级AI代理的指令操作系统实践指南
  • Obsidian插件Quiz Generator：用AI将笔记自动转化为互动测验
  • 鸿蒙一气总论（五）
  • douyin-downloader：抖音内容获取的技术架构与实践应用
  • 丢掉pip，又一Python实用利器出现了～
  • 手把手教你学Simulink——基于光储微电网虚拟同步发电机（VSG）控制仿真示例
  • PyCharm直连Spark集群：一站式配置与避坑指南
  • 告别明文传输：手把手教你为open62541 OPC UA服务器配置OpenSSL加密（附证书生成避坑指南）
  • 基于Dify Chatflow构建游戏客服多智能体系统：从架构设计到工程实践
  • Go语言轻量级HTTP代理curxy：开发调试与本地环境配置利器
  • 从AI编程助手的“糟糕代码”洞察人机协作：调试、优化与未来
  • 别再手动开账号了！用JupyterHub在Ubuntu上搭建团队数据科学环境（附GitHub登录配置）
  • 智能体工程：从氛围编程到结构化AI辅助开发方法论
  • 抖音无水印下载器完整指南：5分钟快速上手免费批量下载
  • WeChatExporter终极指南：三步快速导出微信聊天记录完整备份
  • ESPAsyncWebServer库在Arduino IDE下的完整安装与避坑指南（附依赖库下载）
  • 基于Neo4j与G6构建技能图谱：从图数据库原理到开源项目实战
  • 第127期《安装指南》：好物推荐、亚当手机屏应用及社区兴趣大分享！