适用场景与接口价值在量化选股、实时行情展示或盘中技术分析等场景下开发者往往需要一个数据源稳定、字段规范且具备技术分析能力的 A 股行情接口。传统行情推送方案维护复杂度高、接入复杂静态数据滞后。本接口通过一次 POST 请求返回当日实时行情快照、逐分钟分时数据以及趋势、强弱、振幅等技术分析结果适合以下场景行情看板在 Web 或移动端实时展示个股最新价、涨跌幅、换手率、量比等核心指标。盘中预警基于 VWAP 偏离度、振幅分级等指标触发自定义告警。量化回测获取当日分时明细用于策略复盘或模拟交易。技术分析辅助借用接口内置的趋势研判、强度评分作为信号参考。接口仅需一个 6 位股票代码可带 sh/sz 前缀即可同时获取基础行情和衍生分析减少数据拼接工作。接口能力边界2.1 数据覆盖范围覆盖沪深北交易所全部 A 股包括主板、创业板、科创板、北交所。仅提供当日行情与分时数据不包含历史日线或分钟线如需历史数据需另行使用其他接口。2.2 请求方式与限制方法POST地址https://v1.apizero.cn/api/stock-trend单次请求限制QPS 5/s每秒最多 5 个请求推荐在非高峰时段使用或内置队列控制。数据新鲜度返回字段中的update_time标识数据快照时间交易所行情约 3~5 秒刷新一次分时数据包含从开盘至最新交易时段的逐分钟记录。2.3 两种返回粒度参数值返回内容适用场景full默认基础行情 分时明细(最多241条) 技术分析需要深度分析或可视化simple精简行情快照报价、涨跌、量比、市盈率等仅需最新价与涨跌幅的轻量场景开发者应根据实际需求选择粒度避免获取大量无用数据拖慢响应。请求参数与鉴权接口通过 HTTP Header 携带 API Key 完成鉴权。未登录状态下额度极低仅为测测试途生产环境应使用登录后的 API Key 以获得正常额度。3.1 Header 参数参数名是否必填类型说明Authorization否string格式Bearer 你的 API Key使用登录用户的 Key 可获更高额度Content-Type是string固定为application/json3.2 请求体字段请求体为 JSON 对象包含以下字段字段类型必填默认值说明codestring是无6 位股票代码可带sh/sz前缀如sh600519typestring否full返回粒度full或simplelimitnumber否0全部分时点返回数量最大 2400表示全部最多241条注意code虽然可带前缀但建议统一使用 6 位数字如600519接口会自动识别交易所。cURL 接入示例以下示例请求贵州茅台600519的完整行情与分时数据返回最近 30 个分时点curl -sS \ -X POST \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d {code: 600519, type: full, limit: 30} \ https://v1.apizero.cn/api/stock-trend将YOUR_API_KEY替换为真实 Key 后执行即可获得 JSON 响应。若请求成功HTTP 状态码 200响应中code为 0。使用 Python 接入import requests import json url https://v1.apizero.cn/api/stock-trend headers { Authorization: Bearer YOUR_API_KEY, Content-Type: application/json } payload { code: 600519, type: full, limit: 30 } response requests.post(url, headersheaders, jsonpayload) data response.json() if data.get(code) 0: print(json.dumps(data[data], indent2, ensure_asciiFalse)) else: print(接口异常:, data.get(msg))响应结构解读响应顶层包含code、msg、data、request_id。当code不为 0 时msg说明错误原因。成功时data结构如下5.1 股票基础信息stock字段说明code股票代码6 位name股票全名market市场代码SH/SZ/BJmarket_name市场中文名board板块主板/创业板等trade_date当前交易日trade_status交易状态交易中/休市等update_time最新行情更新时间5.2 实时行情报价quote核心字段字段类型示例说明pricenumber1190.00最新价元changenumber4.51涨跌额change_percentnumber0.38涨跌幅%highnumber1191.99当日最高lownumber1166.33当日最低opennumber1180.10开盘价pre_closenumber1185.49昨收价amplitudenumber2.16振幅%volumenumber18422成交量手volume_displaystring1.84万手成交量文字展示amountnumber2168779690成交额元amount_displaystring21.69亿成交额文字展示turnover_ratenumber0.15换手率%volume_rationumber1.19量比pe_ttmnumber13.65滚动市盈率pbnumber6.31市净率total_mvnumber1487597105190总市值元total_mv_displaystring1.49万亿总市值文字展示avg_pricenumber1180.64当日均价从分时数据计算注意avg_price来自分时明细的加权仅当typefull且当日有分时数据时有效。5.3 涨跌状态change_status字段说明directionup / down / flatcolor颜色代码如 #EB5454 红色表示上涨label文字标签上涨/下跌/平盘5.4 分时明细minute仅在typefull时返回。包含count实际返回数量、total当日总体分时点数量、list分时点数组。每个分时点字段字段说明time分钟时间戳HH:MM 格式price该分钟最后一笔成交价open该分钟开盘价high该分钟最高价low该分钟最低价avg该分钟均价截至该分钟volume该分钟成交量手amount该分钟成交额元change_percent相对于前收盘的涨跌幅%5.5 技术分析analysis仅在typefull时返回包含趋势研判trend文字描述如“震荡上行”trend_direction方向up/down/flatup_minutes上涨分钟数down_minutes下跌分钟数flat_minutes平盘分钟数up_ratio上涨分钟占比%强弱评分strength对象包含level较强/正常/较弱、score当前评分、max_score满分一般5分振幅分级amplitude_level文字描述如“小幅波动”“大幅波动”VWAP 偏离度vwap_deviation当前价相对于当日 VWAP成交量加权均价的偏离百分比。正值表示用量说明高于 VWAP。逐分钟涨跌分布通过up_minutes、down_minutes、flat_minutes即可了解整体日内多空力量分布。5.6 智能摘要summary一个简短的自然语言总结可直接用于客户端展示。常见错误与排查错误码可能原因排查方向1001缺少必要字段 code检查请求体 JSON 是否包含code1002股票代码格式错误确保为 6 位数字或正确的前缀6位1003接口频率超限QPS 5加入请求队列控制并发数1004API Key 无效或额度不足检查 Header 中Authorization值确认 Key 有效且未过期2001股票当天未交易或停牌确认trade_status停牌时行情数据可能为空5000服务端内部错误稍后重试若持续请查看文档或联系支持通用检查清单确认请求地址正确https://v1.apizero.cn/api/stock-trend注意是 HTTPS。确认请求体是合法的 JSON无多余逗号。若使用limit参数确保数值 ≤ 240。对于非交易时段如周末、节假日分时数据将为空trade_status会标识“休市”。工程化注意事项7.1 数据缓存策略由于行情每几秒刷新建议客户端设置合理的轮询间隔如 5~10 秒避免超过 QPS 限制。对于仅需最新价的应用可仅使用typesimple节省资源。分时数据在交易日收盘后基本固定可缓存减少重复请求。7.2 错误重试机制建议实现指数退避重试首次失败等待 1 秒重试后续等待 2 秒、4 秒等最多 3 次。注意区分可重试错误服务端 500与不可重试错误参数错误、Key 无效。7.3 时间与时区处理接口返回的时间字段均为北京时间UTC8。time字段为HH:MM格式表示当日分钟点应结合trade_date使用。注意跨日问题当日分时数据仅在同一天有效。7.4 数据精度与展示数值字段如amount、total_mv单位为元可能较大。建议前端展示时使用接口提供的_display字段如amount_display避免自行拼接单位出错。7.5 同时请求多只股票接口单次仅支持一个股票代码。如需同时获取多只股票行情需发起多次请求注意 QPS 限制。可考虑使用Promise.all或类似并发控制逻辑但不要超过每秒 5 个。参考文档接口文档页https://apizero.cn/aidocs/stock-trend原始 Markdown 文档https://apizero.cn/aidocs/stock-trend/raw.md以上内容基于公开接口文档整理实际使用请以最新文档为准。