메뉴
批量获取多只 ETF 历史 K 线 POST 接口（market.ft.tech，etf-candlesticks/batch）。用户问多只 ETF 的 K 线、批量 ETF 日 K/周 K/月 K/年 K、510300 和 159915 一起的 K 线时使用。必填 --symbols、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
非凸科技金融数据技能集。覆盖 A 股股票列表、全字段/实时行情列表、分时价格、IPO、大宗交易、融资融券、单股行情估值、可转债、ETF、基金、指数（含分页指数描述、下载描述 PDF、权重汇总/成份明细、下载权重 xlsx、详情/K 线/分时）、宏观经济，以及港股公司介绍/估值分析/基础视图/K线、东财美股列表/历史K线/最新行情、native 美股基础信息/利润表/现金流量表/资产负债表、港股财报三表(利润/现金流/资产负债)/东财港股指数日K线等接口（market.ft.tech / ftai.chat）。用户询问 A 股、港股、美股的代码、行情、估值、K线、指数权重/描述、新闻与宏观数据时使用。
按日期范围查询财经日历（market.ft.tech），含华尔街见闻与百度财经日历数据（宏观数据、IPO、财报时间、交易提醒等）。用户问财经日历、经济事件、IPO 日程、财报时间、交易提醒时使用。
查询所有期股权质押总揽数据。当用户需要获取 A 股市场所有报告期的股权质押总揽数据，包括质押公司数量、质押笔数、质押总股数、质押总市值、沪深300指数等信息，支持沪深京股票，或了解所有期股权质押总揽数据时使用。
批量获取多只可转债 K 线 POST 接口（market.ft.tech，convertible-bond-candlesticks/batch）。用户问多只可转债的 K 线、批量可转债日 K/周 K/月 K/年 K 时使用。必填 --symbols、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。
单只可转债历史 K 线 POST 接口（market.ft.tech，convertible-bond-candlesticks）。用户问某只可转债的分/日/周/月/年 K 线、开高低收、前/后复权、分钟级 K 线时使用。必填 --symbol、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。
单只 ETF 历史 K 线 POST 接口（market.ft.tech，etf-candlesticks）。用户问某只 ETF 的分/日/周/月/年 K 线、开高低收、前/后复权、分钟级 K 线、5 分钟/日 K/周 K/月 K/年 K 时使用。必填 --symbol、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。
| name | etf-candlesticks-batch |
| description | 批量获取多只 ETF 历史 K 线 POST 接口（market.ft.tech，etf-candlesticks/batch）。用户问多只 ETF 的 K 线、批量 ETF 日 K/周 K/月 K/年 K、510300 和 159915 一起的 K 线时使用。必填 --symbols、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。 |
| 项目 | 说明 |
|---|---|
| 接口名称 | 批量查询多只 ETF K 线 |
| 外部接口 | POST /api/v1/market/data/etf-candlesticks/batch |
| 请求方式 | POST（JSON body） |
| 适用场景 | 一次拉取多只 ETF 的分/日/周/月/年 K 线。响应为嵌套数组 [[symbol, K线数组], ...]。仅接受 ETF 标的，任一 symbol 非 ETF 时整体返回系统错误 |
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| symbols | string[] | 是 | ETF 代码列表 | 510300.XSHG,159915.XSHE | 逗号分隔传入；也接受 .SH/.SZ 短后缀，响应统一规范化为长后缀 |
| interval_unit | string | 是 | 周期单位 | Day | Minute/Day/Week/Month/Year |
| interval_value | int | 否 | 间隔数值 | 1 | 默认 1；Minute+5 表示 5 分钟 K 线 |
| adjust_kind | string | 否 | 复权类型 | Forward | None（默认）/Forward（前复权）/Backward（后复权） |
| since_ts_millis | int | 否 | 开始时间戳（毫秒） | 1756700000000 | 分钟 K 线与 until 跨度 ≤3 天 |
| until_ts_millis | int | 是 | 结束时间戳（毫秒） | 1756791000000 | - |
| limit | int | 否 | 每个标的返回条数上限 | 2 | 未传 since 和 limit 时每个标的默认最多返回 50 根 |
响应为二元数组列表，每项结构为 [symbol, K线数组]：
| 字段名 | 类型 | 说明 |
|---|---|---|
| [0] | string | ETF 代码；响应统一使用 .XSHG、.XSHE 等长后缀 |
| [1] | array | 该标的的 K 线数组，字段同单只接口 |
K 线单根字段同 etf-candlesticks：open / high / low / close / ts_millis / ts_millis_open / turnover / volume。
python <RUN_PY> etf-candlesticks-batch --symbols 510300.XSHG,159915.XSHE --interval-unit Day --until-ts-millis 1756791000000 --limit 2
python <RUN_PY> etf-candlesticks-batch --symbols 510300.XSHG,159915.XSHE --interval-unit Minute --interval-value 5 --adjust-kind Forward --since-ts-millis 1756700000000 --until-ts-millis 1756791000000
<RUN_PY> 为主 SKILL.md 同级 run.py 的绝对路径。输出 JSON，请求头已内置 X-Client-Name: ft-claw。
symbols、interval_unit、until_ts_millis 必填。symbols 用逗号分隔；任一非 ETF 标的当前外部接口返回系统错误，不静默过滤。symbol 会规范化为长市场后缀（.XSHG/.XSHE）。interval_unit=Minute）的 since/until 跨度硬限制 ≤3 天。interval_value 仅在 interval_unit=Minute 时生效：不传或传 1 为 1 分钟 K，传 5/15/30/60/120 为对应多分钟 K；其他周期忽略该字段。Forward 前复权、Backward 后复权。