ETF30分接口文档

30分历史分钟行情。仅查询已发布的数据；必须显式传 tradedate。单次最多返回 6000 行，建议按单只证券和交易分钟查询。

按数据验收结果发布；盘中已验收批次也可查询。

请求参数

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