一款支持港股、美股、A 股多市场的免费股票行情数据接口服务,能够提供股票基础信息、实时 Tick 数据、实时报价、历史 K 线及批量 K 线等多维度数据,数据返回格式统一为 JSON,接入便捷,满足各类金融数据应用开发需求。本文将详细介绍该 API 的接口规范、使用方法及数据字段说明。
所有 API 接口请求均需携带以下请求头,用于身份验证及数据格式指定,否则将导致请求失败:
接口通过“region”参数区分目标市场,各市场对应的标识及股票代码规则如下,请求时需准确匹配:
用于获取单只股票的基础信息,包括公司名称、所属行业、市值、市盈率等核心数据,为行情分析提供基础支撑。
使用 requests 库发送 GET 请求,需提前安装:pip install requests
获取股票实时行情快照,包含开盘价、最高价、最低价、最新价、成交量等核心行情数据,是行情分析的核心接口。
与“实时 Tick 数据接口”一致,仅需传入 region 和 code 参数。
获取单只股票的历史 K 线数据,支持不同周期类型,可用于技术分析、趋势研判等场景。
支持同时获取多只股票的历史 K 线数据,减少请求次数,提升开发效率,参数及返回格式与单只 K 线接口兼容。
通过 WebSocket 协议实现行情数据推送,支持多只股票同时订阅,实时性优于 HTTP 轮询,适用于高频行情场景。
连接建立后需发送订阅请求,指定目标股票及数据类型:
使用 websockets 库实现 WebSocket 连接,需提前安装:pip install websockets
支持,WebSocket 订阅时 params 参数中可包含多市场股票,只需按"代码$市场"格式正确填写即可,如"AAPL$US,700$HK,300750$CN"。
HTTP 接口数据延迟约 200 毫秒,WebSocket 接口延迟可低至 50 毫秒以内,满足多数实时行情场景需求。