适用场景当你在开发一个A股行情看板、盘中监控工具或量化回测系统时需要实时获取某只股票的当前用量说明、涨跌幅、成交量以及历史分时数据。A股实时行情接口提供了从交易所直接整合的标准化数据覆盖沪深北全部A股既可以获取一秒钟的快照也可以拉取当日从09:30开始的每分钟开盘/最高/最低/收盘价。典型使用场景包括个人看盘小工具快速显示自选股的实时用量说明和涨跌状态。量化交易信号验证截取分钟级K线结合VWAP偏离度判断买卖点。投研分析自动计算振幅等级、趋势方向、强弱评分等衍生指标。接口能力边界在调用前需要明确以下几个限制属性说明API 端点POST https://v1.apizero.cn/api/stock-trend请求粒度单次请求一个股票代码分时数据点数最大 240 个点每交易日 4 小时共 240 分钟可通过limit参数返回最近 N 个点返回粒度full包含行情快照 所有分时点 技术分析simple仅含核心行情每秒查询QPS5 次/秒调用次数限制未登录5 次/天调用次数限制登录用户50 次/天超出额度后按 0.01 元/次计费需账户余额会员可享更高并发。本文仅演示最小可运行调用不涉及付费方案。请求参数与鉴权调用该接口需要传递一个 JSON 对象包含以下字段参数名类型必填说明codestring是6位股票代码可带交易所前缀如600519或sh600519typestring否返回粒度full默认或simplelimitnumber否分时点数量0 表示全部1–240 表示最近 N 个点默认返回所有鉴权方式支持两种 Header 传递方式二选一X-API-Key: 你的 API KeyAuthorization: Bearer 你的 API Key未提供 API Key 时也能请求但额度受限每日 5 次且无法享受登录用户的 50 次额度。建议先在平台准备并获取 Key。最小可运行示例curl以下示例使用贵州茅台600519作为查询对象请求完整分析数据并限制返回最近 30 个分时点。请将$APIZERO_API_KEY替换为你的实际 Key。curl -sS \ -X POST \ -H X-API-Key: $APIZERO_API_KEY \ -H Content-Type: application/json \ -d {code: 600519, type: full, limit: 30} \ https://v1.apizero.cn/api/stock-trend关键说明-sS参数抑制进度条但显示错误。-X POST显式指定方法。请求体中的limit: 30表示只取最后 30 分钟的分时数据减少传输量。若使用 Bearer 方式替换 Header 为-H Authorization: Bearer $APIZERO_API_KEY。返回结果是一个 JSON 对象包含code、msg、data和request_id。返回字段逐层解读顶层结构{ code: 0, msg: 成功, request_id: abc123, data: { ... } }code: 0 表示成功非 0 表示错误。msg: 状态描述。request_id: 请求唯一标识可用于排查日志。data: 核心数据对象。data.stock股票基本信息字段类型含义codestring股票代码namestring股票名称marketstring交易所代码SH/SZ/BJboardstring板块主板/创业板/科创板trade_statusstring交易状态交易中/休市trade_datestring交易日update_timestring数据更新时间data.quote实时行情快照这是最常用的部分包含当前最新价、涨跌、成交量等字段类型含义pricenumber最新成交价changenumber涨跌额元change_percentnumber涨跌幅%opennumber开盘价highnumber今日最高价lownumber今日最低价pre_closenumber昨收价volumenumber成交量股amountnumber成交额元amplitudenumber振幅%turnover_ratenumber换手率%volume_rationumber量比pe_ttmnumber滚动市盈率pbnumber市净率total_mvnumber总市值元avg_pricenumber均价元还有对应的_display字段如amount_display: 21.69亿方便直接展示。data.change_status涨跌状态{ color: #EB5454, direction: up, label: 上涨 }用于快速渲染红绿颜色direction可取值up/down/flat。data.minute分时数据列表minute.list是一个数组每元素代表一分钟的快照字段类型含义timestring时间戳如 09:31opennumber该分钟开盘价highnumber该分钟最高价lownumber该分钟最低价pricenumber该分钟收盘价即该分钟最后一笔成交avgnumber该分钟均价volumenumber该分钟成交量股amountnumber该分钟成交额元change_percentnumber该分钟相较于前一日收盘价的涨跌幅%minute.count表示返回的点数minute.total表示当日总分钟数通常 241。data.analysis技术分析该模块提供了若干量化指标trend: 趋势判断如“震荡上行”trend_direction: 方向枚举up/down/flatstrength: 强弱评分对象包含score0–5和level较弱/中等/较强amplitude_level: 振幅分级如“小幅波动”up_minutes/down_minutes/flat_minutes: 上涨/下跌/平盘分钟数up_ratio: 上涨分钟占比%vwap_deviation: 当前价相对于 VWAP 的偏离度%这些字段可以直接用于生成行情标签或量化条件筛选。data.summary文本摘要一个自然语言句子总结当日走势例如“贵州茅台今日上涨0.38%现价1190.0振幅2.16%换手0.15%整体呈震荡上行态势波动强度较弱。”常见错误与排查错误表现可能原因解决方式code非 0msg包含“参数错误”请求 JSON 格式错误或code不足 6 位检查 JSON 是否合法股票代码必须是 6 位数字code非 0msg包含“鉴权失败”API Key 未传或无效确认 Header 名称和 Key 值是否正确返回 HTTP 429超出 QPS 限制5次/秒加入请求间隔控制或降低并发返回空的分时列表或count0非交易时段或股票当日停牌检查trade_status字段msg包含“额度不足”当日调用次数限制用完登录账户获取更多额度或等待次日重置工程化注意事项1. 限流与重试由于 QPS 限制为 5如果需要在短时间内查询多只股票建议使用队列或令牌桶控制请求频率。示例伪代码import time import requests def fetch_stock(code, api_key): url https://v1.apizero.cn/api/stock-trend headers {X-API-Key: api_key, Content-Type: application/json} payload {code: code, type: full, limit: 30} resp requests.post(url, jsonpayload, headersheaders) # 如果遇到 429等待 0.2 秒再重试最多 3 次 if resp.status_code 429: time.sleep(0.2) resp requests.post(url, jsonpayload, headersheaders) return resp.json()2. 分时数据缓存分时数据在交易日内每分钟更新一次但对于非实时看板如盘后分析可以缓存到本地数据库避免重复请求减少额度消耗。3.typesimple与typefull的选择如果仅需要当前用量说明和涨跌幅使用simple即可返回数据体积更小速度更快。full适合需要分时 K 线和额外技术分析的情景。4. 处理非交易时段在 15:00 之后或周末调用trade_status可能为“休市”分时列表为空。应设计逻辑判断trade_status避免误展示空白图表。5. 多账户轮转如果需要高于 50 次/天的额度可以合理使用多个账户的调用次数限制每个账户 50 次但注意不要滥用。或者直接开通会员获取更高 QPS 与次数。参考文档A股实时行情 API 文档原始接口定义Markdown以上即为最小可运行示例的全部内容。开发者可根据本文的 curl 示例迅速验证连通性然后根据返回字段构建自己的行情展示或分析逻辑。
A股实时行情API最小可运行示例：从curl到参数全解
适用场景当你在开发一个A股行情看板、盘中监控工具或量化回测系统时需要实时获取某只股票的当前用量说明、涨跌幅、成交量以及历史分时数据。A股实时行情接口提供了从交易所直接整合的标准化数据覆盖沪深北全部A股既可以获取一秒钟的快照也可以拉取当日从09:30开始的每分钟开盘/最高/最低/收盘价。典型使用场景包括个人看盘小工具快速显示自选股的实时用量说明和涨跌状态。量化交易信号验证截取分钟级K线结合VWAP偏离度判断买卖点。投研分析自动计算振幅等级、趋势方向、强弱评分等衍生指标。接口能力边界在调用前需要明确以下几个限制属性说明API 端点POST https://v1.apizero.cn/api/stock-trend请求粒度单次请求一个股票代码分时数据点数最大 240 个点每交易日 4 小时共 240 分钟可通过limit参数返回最近 N 个点返回粒度full包含行情快照 所有分时点 技术分析simple仅含核心行情每秒查询QPS5 次/秒调用次数限制未登录5 次/天调用次数限制登录用户50 次/天超出额度后按 0.01 元/次计费需账户余额会员可享更高并发。本文仅演示最小可运行调用不涉及付费方案。请求参数与鉴权调用该接口需要传递一个 JSON 对象包含以下字段参数名类型必填说明codestring是6位股票代码可带交易所前缀如600519或sh600519typestring否返回粒度full默认或simplelimitnumber否分时点数量0 表示全部1–240 表示最近 N 个点默认返回所有鉴权方式支持两种 Header 传递方式二选一X-API-Key: 你的 API KeyAuthorization: Bearer 你的 API Key未提供 API Key 时也能请求但额度受限每日 5 次且无法享受登录用户的 50 次额度。建议先在平台准备并获取 Key。最小可运行示例curl以下示例使用贵州茅台600519作为查询对象请求完整分析数据并限制返回最近 30 个分时点。请将$APIZERO_API_KEY替换为你的实际 Key。curl -sS \ -X POST \ -H X-API-Key: $APIZERO_API_KEY \ -H Content-Type: application/json \ -d {code: 600519, type: full, limit: 30} \ https://v1.apizero.cn/api/stock-trend关键说明-sS参数抑制进度条但显示错误。-X POST显式指定方法。请求体中的limit: 30表示只取最后 30 分钟的分时数据减少传输量。若使用 Bearer 方式替换 Header 为-H Authorization: Bearer $APIZERO_API_KEY。返回结果是一个 JSON 对象包含code、msg、data和request_id。返回字段逐层解读顶层结构{ code: 0, msg: 成功, request_id: abc123, data: { ... } }code: 0 表示成功非 0 表示错误。msg: 状态描述。request_id: 请求唯一标识可用于排查日志。data: 核心数据对象。data.stock股票基本信息字段类型含义codestring股票代码namestring股票名称marketstring交易所代码SH/SZ/BJboardstring板块主板/创业板/科创板trade_statusstring交易状态交易中/休市trade_datestring交易日update_timestring数据更新时间data.quote实时行情快照这是最常用的部分包含当前最新价、涨跌、成交量等字段类型含义pricenumber最新成交价changenumber涨跌额元change_percentnumber涨跌幅%opennumber开盘价highnumber今日最高价lownumber今日最低价pre_closenumber昨收价volumenumber成交量股amountnumber成交额元amplitudenumber振幅%turnover_ratenumber换手率%volume_rationumber量比pe_ttmnumber滚动市盈率pbnumber市净率total_mvnumber总市值元avg_pricenumber均价元还有对应的_display字段如amount_display: 21.69亿方便直接展示。data.change_status涨跌状态{ color: #EB5454, direction: up, label: 上涨 }用于快速渲染红绿颜色direction可取值up/down/flat。data.minute分时数据列表minute.list是一个数组每元素代表一分钟的快照字段类型含义timestring时间戳如 09:31opennumber该分钟开盘价highnumber该分钟最高价lownumber该分钟最低价pricenumber该分钟收盘价即该分钟最后一笔成交avgnumber该分钟均价volumenumber该分钟成交量股amountnumber该分钟成交额元change_percentnumber该分钟相较于前一日收盘价的涨跌幅%minute.count表示返回的点数minute.total表示当日总分钟数通常 241。data.analysis技术分析该模块提供了若干量化指标trend: 趋势判断如“震荡上行”trend_direction: 方向枚举up/down/flatstrength: 强弱评分对象包含score0–5和level较弱/中等/较强amplitude_level: 振幅分级如“小幅波动”up_minutes/down_minutes/flat_minutes: 上涨/下跌/平盘分钟数up_ratio: 上涨分钟占比%vwap_deviation: 当前价相对于 VWAP 的偏离度%这些字段可以直接用于生成行情标签或量化条件筛选。data.summary文本摘要一个自然语言句子总结当日走势例如“贵州茅台今日上涨0.38%现价1190.0振幅2.16%换手0.15%整体呈震荡上行态势波动强度较弱。”常见错误与排查错误表现可能原因解决方式code非 0msg包含“参数错误”请求 JSON 格式错误或code不足 6 位检查 JSON 是否合法股票代码必须是 6 位数字code非 0msg包含“鉴权失败”API Key 未传或无效确认 Header 名称和 Key 值是否正确返回 HTTP 429超出 QPS 限制5次/秒加入请求间隔控制或降低并发返回空的分时列表或count0非交易时段或股票当日停牌检查trade_status字段msg包含“额度不足”当日调用次数限制用完登录账户获取更多额度或等待次日重置工程化注意事项1. 限流与重试由于 QPS 限制为 5如果需要在短时间内查询多只股票建议使用队列或令牌桶控制请求频率。示例伪代码import time import requests def fetch_stock(code, api_key): url https://v1.apizero.cn/api/stock-trend headers {X-API-Key: api_key, Content-Type: application/json} payload {code: code, type: full, limit: 30} resp requests.post(url, jsonpayload, headersheaders) # 如果遇到 429等待 0.2 秒再重试最多 3 次 if resp.status_code 429: time.sleep(0.2) resp requests.post(url, jsonpayload, headersheaders) return resp.json()2. 分时数据缓存分时数据在交易日内每分钟更新一次但对于非实时看板如盘后分析可以缓存到本地数据库避免重复请求减少额度消耗。3.typesimple与typefull的选择如果仅需要当前用量说明和涨跌幅使用simple即可返回数据体积更小速度更快。full适合需要分时 K 线和额外技术分析的情景。4. 处理非交易时段在 15:00 之后或周末调用trade_status可能为“休市”分时列表为空。应设计逻辑判断trade_status避免误展示空白图表。5. 多账户轮转如果需要高于 50 次/天的额度可以合理使用多个账户的调用次数限制每个账户 50 次但注意不要滥用。或者直接开通会员获取更高 QPS 与次数。参考文档A股实时行情 API 文档原始接口定义Markdown以上即为最小可运行示例的全部内容。开发者可根据本文的 curl 示例迅速验证连通性然后根据返回字段构建自己的行情展示或分析逻辑。
