最小可运行示例：A股实时行情API接入指南

适用场景A股实时行情API适用于行情展示、量化回测、投研分析等需要获取沪深北交易所全部A股实时用量说明与分时走势的场景。开发者输入6位股票代码即可获得最新价、涨跌幅、分时K线、趋势判断等结构化数据无需自建行情采集系统。接口能力边界QPS限制每秒最多5次请求以文档为准超出返回频率限制错误。数据覆盖上海、深圳、北京交易所所有A股包含主板、科创板、创业板。返回粒度支持full完整分析逐分钟分时和simple精简行情快照。分时点数最多返回241个分钟点包含09:30~15:00可通过limit参数控制返回最近N个点。调用次数限制未登录每日5次登录用户每日50次。超出后按量计费¥0.01/次会员有更高额度。鉴权与请求头接口使用Bearer Token鉴权需要将API Key放在请求头中Authorization: Bearer 你的API Key也可通过X-API-Key头传递示例curl中使用此方式。建议将API Key存放在环境变量中避免硬编码。请求参数详解请求方法为POST请求体为JSON对象包含三个字段参数名类型必填说明示例codestring是6位股票代码可带前缀sh/sz600519或sz000001typestring否返回粒度full完整或simple精简默认fullfulllimitnumber否分时点数量0返回全部最多2410返回最近N个最大24030注意若type为simple响应中minute字段将为空列表analysis可能不存在。curl 最小可运行示例以下命令使用两个环境变量API_KEY和STOCK_CODE替换为真实值即可运行curl -sS \ -X POST \ -H X-API-Key: ${API_KEY:?请设置API_KEY环境变量} \ -H Content-Type: application/json \ -d {code: ${STOCK_CODE:-600519}, type: full, limit: 30} \ https://v1.apizero.cn/api/stock-trend若不想使用环境变量可以直接填入明文注意安全性curl -sS -X POST -H X-API-Key: your_api_key_here -H Content-Type: application/json -d {code: 601318, type: simple, limit: 10} https://v1.apizero.cn/api/stock-trend返回的JSON可直接用jq格式化查看curl -sS ... | jq .使用 Python 快速接入以下是最小可运行Python脚本需要安装requests库import os import requests API_KEY os.environ.get(API_KEY, your_api_key) URL https://v1.apizero.cn/api/stock-trend payload { code: 600519, type: full, limit: 30 } headers { X-API-Key: API_KEY, Content-Type: application/json } resp requests.post(URL, jsonpayload, headersheaders) data resp.json() if data.get(code) 0: print(请求成功股票名称:, data[data][stock][name]) print(最新价:, data[data][quote][price]) print(涨跌幅:, data[data][quote][change_percent], %) else: print(请求失败:, data.get(msg))运行前设置环境变量export API_KEY你的真实Key。返回字段解读成功响应结构如下以full为例{ code: 0, msg: 成功, request_id: abc123, data: { stock: { ... }, quote: { ... }, minute: { ... }, analysis: { ... }, change_status: { ... }, summary: ... } }4.1 stock – 股票基本信息字段类型说明codestring股票代码namestring股票名称marketstring交易所代码SH/SZ/BJmarket_namestring交易所名称boardstring板块主板、科创板、创业板等trade_datestring交易日trade_statusstring交易状态“交易中” / “休市” / “集合竞价” 等update_timestring数据更新时间4.2 quote – 实时行情快照字段类型说明pricenumber最新价元changenumber涨跌额change_percentnumber涨跌幅百分比opennumber开盘价highnumber最高价lownumber最低价pre_closenumber昨收价amplitudenumber振幅百分比volumenumber成交量股volume_displaystring格式化成交量如“1.84万手”amountnumber成交额元amount_displaystring格式化成交额如“21.69亿”avg_pricenumber均价turnover_ratenumber换手率百分比volume_rationumber量比pe_ttmnumber市盈率TTMpbnumber市净率total_mvnumber总市值元total_mv_displaystring格式化总市值4.3 minute – 分时数据minute对象包含count返回点数和list分时点数组。每个分时点字段如下字段类型说明timestring时间如09:31pricenumber成交价opennumber该分钟开盘价highnumber该分钟最高价lownumber该分钟最低价avgnumber该分钟均价volumenumber成交量股amountnumber成交额元change_percentnumber可选该分钟相对于前收盘的涨跌幅4.4 analysis – 技术分析字段类型说明trendstring趋势判断如“震荡上行”trend_directionstring方向up/down/sidewaysamplitude_levelstring振幅分级如“小幅波动”strengthobject强弱评分score得分、max_score满分、level等级up_minutesnumber上涨分钟数down_minutesnumber下跌分钟数flat_minutesnumber持平分钟数up_rationumber上涨占比百分比vwap_deviationnumber当前价相对于VWAP的偏离度百分比4.5 change_status – 涨跌状态字段类型说明directionstring方向up/down/flatlabelstring文本标签如“上涨”colorstring十六进制颜色如#EB5454红涨4.6 summary – 自然语言总结一段简短的行情描述可直接用于UI展示。错误处理与常见问题响应code含义处理建议0成功正常解析data1001参数缺失或无效检查code是否为6位数字或合法的sh/sz前缀1002API Key无效或额度不足检查API Key是否正确或查看账户余额1003频率超限QPS添加请求间隔至少200ms或升级会员1004股票代码不存在确认股票代码属于A股且未退市1005系统内部错误重试若持续报错联系技术支持注意simple模式下如果limit大于0返回的分时点列表可能为空因为type为simple时不返回分时数据。建议simple仅用于行情快照。工程化注意事项限流与重试由于QPS为5建议使用令牌桶或队列控制请求频率。对于批量查询可分批并发控制并发数不超过5。数据缓存行情数据变化快但分钟级数据可在客户端缓存5秒~30秒以减少请求次数。分时数据在盘中每分钟更新可轮询但需控制间隔。异常处理网络抖动时建议使用指数退避重试如1s、2s、4s最多3次。注意服务器返回5xx时不要无限制重试。时区与交易日数据基于北京时间UTC8交易日为周一至周五节假日除外。可通过trade_status判断是否在交易中。隐私安全API Key不应暴露在客户端代码或Git仓库中。建议使用后端代理转发或存储在环境变量/密钥管理服务中。字段解析响应中金额单位均为“元”成交量单位为“股”换手率、涨跌幅等百分比字段已除以100如0.38%对应0.38。参考文档A股实时行情接口文档原始文档raw本文所有接口参数与返回字段均来自官方文档请以文档最新版本为准。