tqsdk.tools.DataDownloader - 数据下载工具
- class tqsdk.tools.DataDownloader(api: TqApi, symbol_list: str | List[str], dur_sec: int, start_dt: date | datetime, end_dt: date | datetime, csv_file_name: str | StreamWriter, write_mode: str = 'w', adj_type: str | None = None)
数据下载工具是 TqSdk 专业版中的功能,能让用户下载目前 TqSdk 提供的全部期货、期权和股票类的历史数据,下载数据支持 tick 级别精度和任意 kline 周期
如果想使用数据下载工具,可以点击 天勤量化专业版 申请使用或购买
历史数据下载器, 输出到csv文件
多合约按时间横向对齐
创建历史数据下载器实例
- Args:
api (TqApi): TqApi实例,该下载器将使用指定的api下载数据
symbol_list (str/list of str): 需要下载数据的合约代码,当指定多个合约代码时将其他合约按第一个合约的交易时间对齐
dur_sec (int): 数据周期,以秒为单位。例如: 1分钟线为60,1小时线为3600,日线为86400,Tick数据为0
- start_dt (date/datetime): 起始时间
date: 指的是交易日
datetime: 指的是具体时间点,如果没有指定时区信息,则默认为北京时间
- end_dt (date/datetime): 结束时间
date: 指的是交易日
datetime: 指的是具体时间点,如果没有指定时区信息,则默认为北京时间
- csv_file_name (str/StreamWriter): [必填]输出方式:
str : 输出 csv 的文件名
StreamWriter: 直接将内容输出到 StreamWriter
write_mode (str): 写入模式,默认值为 "w"。"w" 表示覆盖写入,会写入标题行,再写入数据;"a" 表示追加写入,不写标题行,直接写入数据。
adj_type (str/None): 复权计算方式,默认值为 None。"F" 为前复权;"B" 为后复权;None 表示不复权。只对股票、基金合约有效。
Example:
from datetime import datetime, date from contextlib import closing from tqsdk import TqApi, TqAuth, TqSim from tqsdk.tools import DataDownloader api = TqApi(auth=TqAuth("快期账户", "账户密码")) download_tasks = {} # 下载从 2018-01-01 到 2018-09-01 的 SR901 日线数据 download_tasks["SR_daily"] = DataDownloader(api, symbol_list="CZCE.SR901", dur_sec=24*60*60, start_dt=date(2018, 1, 1), end_dt=date(2018, 9, 1), csv_file_name="SR901_daily.csv") # 下载从 2017-01-01 到 2018-09-01 的 rb主连 5分钟线数据 download_tasks["rb_5min"] = DataDownloader(api, symbol_list="KQ.m@SHFE.rb", dur_sec=5*60, start_dt=date(2017, 1, 1), end_dt=date(2018, 9, 1), csv_file_name="rb_5min.csv") # 下载从 2018-01-01凌晨6点 到 2018-06-01下午4点 的 cu1805,cu1807,IC1803 分钟线数据,所有数据按 cu1805 的时间对齐 # 例如 cu1805 夜盘交易时段, IC1803 的各项数据为 N/A # 例如 cu1805 13:00-13:30 不交易, 因此 IC1803 在 13:00-13:30 之间的K线数据会被跳过 download_tasks["cu_min"] = DataDownloader(api, symbol_list=["SHFE.cu1805", "SHFE.cu1807", "CFFEX.IC1803"], dur_sec=60, start_dt=datetime(2018, 1, 1, 6, 0 ,0), end_dt=datetime(2018, 6, 1, 16, 0, 0), csv_file_name="cu_min.csv") # 下载从 2018-05-01凌晨0点 到 2018-06-01凌晨0点 的 T1809 盘口Tick数据 download_tasks["T_tick"] = DataDownloader(api, symbol_list=["CFFEX.T1809"], dur_sec=0, start_dt=datetime(2018, 5, 1), end_dt=datetime(2018, 6, 1), csv_file_name="T1809_tick.csv") # 使用with closing机制确保下载完成后释放对应的资源 with closing(api): while not all([v.is_finished() for v in download_tasks.values()]): api.wait_update() print("progress: ", { k:("%.2f%%" % v.get_progress()) for k,v in download_tasks.items() })