前言期货量化研究常需要比“实时订阅几分钟 K 线”更长的历史例如 2017–2024 年螺纹钢 5 分钟线做回测或国债期货 tick 盘口做微观结构研究。手动截图或零散 CSV 难以维护。天勤 TqSdk 提供DataDownloader数据下载工具文档标明属于专业版能力需按官网申请或购买可把期货、期权等历史数据落到 CSV支持 K 线任意周期 与 tickdur_sec0。下面说明DataDownloader的参数含义、多合约对齐、增量写入以及和实时get_kline_serial的分工。需如实说明DataDownloader 属于天勤专业版能力未开通时应以实时订阅与TqBacktest为主勿把下载工具当成默认免费功能。一、DataDownloader 解决什么问题实时策略用wait_updateget_kline_serial只保留有限data_length缓冲。研究侧若要数年历史应用下载器拉本地 CSV再在 Pandas 里做特征、或喂给TqBacktest之外的离线框架。官方示例要点dur_sec周期秒数日线 864001 分钟 60tick 为 0。symbol_list一个或多个合约多合约时按第一个合约的交易时间对齐不对齐的时段填 N/A。start_dt/end_dt可为 date交易日或 datetime具体时刻默认北京时间。write_modew覆盖写写表头a追加不写表头便于增量。二、最小示例K 线与 tickfromdatetimeimportdate,datetimefromcontextlibimportclosingfromtqsdkimportTqApi,TqAuthfromtqsdk.toolsimportDataDownloader apiTqApi(authTqAuth(快期账户,密码))tasks{}tasks[rb_5m]DataDownloader(api,symbol_listKQ.mSHFE.rb,dur_sec5*60,start_dtdate(2020,1,1),end_dtdate(2024,12,31),csv_file_namerb_5m.csv,)tasks[tick]DataDownloader(api,symbol_listCFFEX.T2509,dur_sec0,start_dtdatetime(2025,3,1),end_dtdatetime(2025,3,31),csv_file_nameT_tick.csv,)withclosing(api):whilenotall(t.is_finished()fortintasks.values()):api.wait_update()下载过程仍要wait_update驱动用closing(api)确保结束释放连接。三、组织方式建议实践说明按品种分目录data/SHFE/rb/5m.csv任务字典多合约多周期tasks[name]DataDownloader(...)增量新时间段用write_modea注意不重复表头主连研究KQ.m适合长历史实盘映射另表记录元数据记录下载日、dur_sec、复权 adj_type股票用期货主力换月导致主连拼接研究结论要知悉与具体月实盘的差异见主连专题。四、与实时策略衔接研究 CSV 算出的信号规则迁到实盘应改get_kline_serialdatetime触发不要长期混用“读 CSV 最后一行”和“读 serial [-2]”两套索引语义。五、权限与预期文档写明 DataDownloader 为专业版功能无权限时向官网申请。下载速度与区间长度、网络有关宜分批按年下载。总结DataDownloader 的价值不止于把历史数据“下载下来”更在于让研究流程拥有可复现的时间轴、文件规范与增量策略。数据层组织得越清楚后面的特征研究、回测对照和实盘迁移越能保持同一口径你能追溯每个 CSV 是何时、用什么 dur_sec 与区间生成的也能避免把不同时间范围或不同订阅口径的结论混在一起。把这套规范固化到项目目录与脚本里最终你拿到的不是“看起来能跑的代码”而是一套研究到执行能自然衔接的工程体系。FAQ1无专业版怎么办用回测、实时缓存、或第三方数据勿编造下载 API。2多品种对齐 N/A文档说明非交易时段另一合约为 N/A分析时要知道。3主连能否 tick 下载以 symbol 是否支持为准先小区间试。4下完如何增量追加write_modeastart_dt 接上次 end_dt 之后。风险提示本文介绍数据工具不构成投资建议。
国内期货历史 tick 与 K 线批量下载：DataDownloader 组织方式
前言期货量化研究常需要比“实时订阅几分钟 K 线”更长的历史例如 2017–2024 年螺纹钢 5 分钟线做回测或国债期货 tick 盘口做微观结构研究。手动截图或零散 CSV 难以维护。天勤 TqSdk 提供DataDownloader数据下载工具文档标明属于专业版能力需按官网申请或购买可把期货、期权等历史数据落到 CSV支持 K 线任意周期 与 tickdur_sec0。下面说明DataDownloader的参数含义、多合约对齐、增量写入以及和实时get_kline_serial的分工。需如实说明DataDownloader 属于天勤专业版能力未开通时应以实时订阅与TqBacktest为主勿把下载工具当成默认免费功能。一、DataDownloader 解决什么问题实时策略用wait_updateget_kline_serial只保留有限data_length缓冲。研究侧若要数年历史应用下载器拉本地 CSV再在 Pandas 里做特征、或喂给TqBacktest之外的离线框架。官方示例要点dur_sec周期秒数日线 864001 分钟 60tick 为 0。symbol_list一个或多个合约多合约时按第一个合约的交易时间对齐不对齐的时段填 N/A。start_dt/end_dt可为 date交易日或 datetime具体时刻默认北京时间。write_modew覆盖写写表头a追加不写表头便于增量。二、最小示例K 线与 tickfromdatetimeimportdate,datetimefromcontextlibimportclosingfromtqsdkimportTqApi,TqAuthfromtqsdk.toolsimportDataDownloader apiTqApi(authTqAuth(快期账户,密码))tasks{}tasks[rb_5m]DataDownloader(api,symbol_listKQ.mSHFE.rb,dur_sec5*60,start_dtdate(2020,1,1),end_dtdate(2024,12,31),csv_file_namerb_5m.csv,)tasks[tick]DataDownloader(api,symbol_listCFFEX.T2509,dur_sec0,start_dtdatetime(2025,3,1),end_dtdatetime(2025,3,31),csv_file_nameT_tick.csv,)withclosing(api):whilenotall(t.is_finished()fortintasks.values()):api.wait_update()下载过程仍要wait_update驱动用closing(api)确保结束释放连接。三、组织方式建议实践说明按品种分目录data/SHFE/rb/5m.csv任务字典多合约多周期tasks[name]DataDownloader(...)增量新时间段用write_modea注意不重复表头主连研究KQ.m适合长历史实盘映射另表记录元数据记录下载日、dur_sec、复权 adj_type股票用期货主力换月导致主连拼接研究结论要知悉与具体月实盘的差异见主连专题。四、与实时策略衔接研究 CSV 算出的信号规则迁到实盘应改get_kline_serialdatetime触发不要长期混用“读 CSV 最后一行”和“读 serial [-2]”两套索引语义。五、权限与预期文档写明 DataDownloader 为专业版功能无权限时向官网申请。下载速度与区间长度、网络有关宜分批按年下载。总结DataDownloader 的价值不止于把历史数据“下载下来”更在于让研究流程拥有可复现的时间轴、文件规范与增量策略。数据层组织得越清楚后面的特征研究、回测对照和实盘迁移越能保持同一口径你能追溯每个 CSV 是何时、用什么 dur_sec 与区间生成的也能避免把不同时间范围或不同订阅口径的结论混在一起。把这套规范固化到项目目录与脚本里最终你拿到的不是“看起来能跑的代码”而是一套研究到执行能自然衔接的工程体系。FAQ1无专业版怎么办用回测、实时缓存、或第三方数据勿编造下载 API。2多品种对齐 N/A文档说明非交易时段另一合约为 N/A分析时要知道。3主连能否 tick 下载以 symbol 是否支持为准先小区间试。4下完如何增量追加write_modeastart_dt 接上次 end_dt 之后。风险提示本文介绍数据工具不构成投资建议。
