ETF30分接口文档

查询 30 分钟 ETF 分钟行情；最新交易日优先返回盘中实时分钟缓存，历史日期读取沉淀分钟线。单次最多返回 6000 行；结果按 `symbol` 升序、`trademin` 升序排列，超过时截取前 6000 行；如需完整数据，请拆分 `symbols` 查询。

传入 ETF 代码时返回该 ETF 当日可用分钟序列；不传代码时返回指定交易分钟的 ETF 列表。

最新交易日盘中每3秒更新；历史分钟线按午间、收盘批次沉淀，批次未发布时无数据。

请求参数

• apiname（string（etf_minute），必选）：固定接口名称，用于选择对应的数据能力。
• apikey（string，必选）：猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
• fields（string|null，可选）：需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
• params（object，可选）：查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。
• symbols（string|array<string>，可选）：ETF 代码，支持单个、多个逗号分隔或数组；不传则默认指定分钟的全市场 ETF。
• tradedate（string，可选）：查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。
• trademin（string，可选）：交易分钟，格式 HHMM，需使用 30m 周期实际收盘桶，例如 1000；交易时段为 0930～1130、1301～1500。传入 symbols 但不传本参数时返回标的当日可用分钟序列；symbols 和本参数都不传时，最新交易日取当前周期桶，历史交易日取最新可用桶。
• period（string（30m），可选）：分钟周期，本接口固定为 30m。

返回字段

• tradedate（string）：日期格式：YYYYMMDD。
• symbol（string）：包含市场后缀的完整ETF代码。
• trademin（string）：格式：HHmm。
• time（string）：格式：HH:mm:ss。
• open（number|null）：当前分钟的开盘价或指数点位。
• high（number|null）：当前分钟的最高价或指数点位。
• low（number|null）：当前分钟的最低价或指数点位。
• close（number|null）：当前分钟的收盘价、最新价或指数点位。
• vol（number|null）：由相邻累计成交量差分得到；数据缺失时返回 null。
• amount（number|null）：由相邻累计成交额差分得到；数据缺失时返回 null。
• vwap（number|null）：当日截至该分钟的累计成交额 ÷（累计成交量 × 100），使用 ROUND_HALF_UP 保留三位小数；09:30 包含集合竞价，午后延续上午累计，零成交分钟沿用累计值，首笔成交前或 2025-08-21 之前未回填数据返回 null。