1、基本思想
在 xtquant 中，历史数据要先下载（download_history_data）到本地的缓存文件中，之后才能获取（get_market_data）使用。
如果确认之前已经下载过，且数据完整，那么后续使用前可以不用再次下载。
2、常用函数
xtdata.download_history_data() # 下载单个资产的历史数据
xtdata.download_history_data2() # 下载多个资产（资产代码装在[]中）的历史数据
xtdata.get_market_data() # 从已下载的本地数据中取数据方法1
xtdata.get_market_data_ex() # 从已下载的本地数据中取数据方法2
xtdata.get_local_data() # 从本地取已下载的数据
为方便，其中 get_market_data 和 get_market_data_ex 合称 gmd 函数。
以下分别简介各个函数的用法。
2.1、下载资产历史数据到本地缓存文件中
下载资产的历史数据，需要用到 download_history_data 和 download_history_data2，他们的使用方法几乎一样。
download_history_data 的使用方法是：
# download_history_data
xtdata.download_history_data(
stock_code='xxxxxx.SH',
period='1x',
start_time='20230101',
end_time='20231115',
incrementally=True) # 是否只下载增量数据
)
# download_history_data2
def on_callback(data):
print("data call back!")
print(data)
xtdata.download_history_data2(
stock_list=['xxxxxx.SH', 'xxxxxx.SZ'],
period='1x',
start_time='20230101',
end_time='20231115',
callback=on_callback,
incrementally=True) # 是否只下载增量数据
)
其中：
1、period 的取值是 ：1m、5m、15m、30m、1h、1d、tick。。。 时，能取到指定资产指定周期的行情数据
2、period 的取值是：transactioncount1d、orderflow1m 时，能取到指定资产的资金流向数据、订单流数据等数据（需要权限）
3、period 的取值是：northfinancechange1m，同时资产代价是 ’FFFFFF.SGT’ 或者 [‘FFFFFF.SGT’]，能取到北向资金数据（需要权限）。其他可下载数据见官方知识库。
4、start_time、end_time 的格式是 ‘yyyymmddHHMMSS’，当只取日线数据时，可以简化为 ‘yyyymmdd’
5、当 start_time=“”，就是从该资产的历史最早时间开始取，当 end_time=“”，就是取到该资产最新的历史数据（如果取的是日内数据，就按周期取到当时最近的日内数据），两者可以都为 “”…
6、download_history_data2 相对 download_history_data 的改进，除了能批量下载资产的历史数据，还支持回调函数
7、incrementally=True 时，用download_history_data2下载多个资产的历史数据，如果不同资产的最新数据日期不同，download_history_data2能根据各个资产的最新日期补齐数据至end_time
8、使用 token 的模式下，支持下载到指定目录，具体实现后续再展开（坑1）
2.2、从本地获取历史数据
get_market_data、get_market_data_ex、get_local_data 都是从本地数据缓存中获取已经下载的数据，三个函数的使用参数也差不多：
history_data = xtdata.get_market_data(
field_list=[],
stock_list=etf_list,
period=period,
start_time=start_date,
end_time=end_date,
count=-1,
dividend_type='none',
fill_data=True
)
xtdata.get_market_data_ex(
field_list=[],# 字段
stock_list=[],# 合约代码列表
period='1d',# 数据周期——1m、5m、1d、tick
start_time='',# 数据起始时间%Y%m%d或%Y%m%d%H%M%S
end_time='',# 数据结束时间%Y%m%d或%Y%m%d%H%M%S
count=-1, # 数据个数。1为只取最新的行情数据，-1为取全部数据
dividend_type='none', # 除权方式
fill_data=True, # 是否填充数据
)
xtdata.get_local_data(
field_list=[],# 字段
stock_list=[],# 合约代码列表
period='1d',# 数据周期——1m、5m、1d、tick
start_time='',# 数据起始时间%Y%m%d或%Y%m%d%H%M%S
end_time='',# 数据结束时间%Y%m%d或%Y%m%d%H%M%S
count=-1, # 数据个数。1为只取最新的行情数据，-1为取全部数据
dividend_type='none', # 除权方式
fill_data=True, # 是否填充数据
)
三者的共同点是，返回的都是 {keys: DataFrames} 格式的数据
三者的区别是：
get_market_data 返回的是两层 dict，第一层 key 是资产代码，第二层 key 是 field_list 中的每个字段，第二层 value 是对应字段的 DataFrame 类型的数据，内容除了本地数据，在订阅之后，也包含有最新的行情数据。
get_market_data_ex 返回的是一层dict，key是 资产代码，value 是包含 field_list 中的所有字段的 DataFrame，内容除了本地数据，在订阅之后，也包含有最新的行情数据。
get_local_data 返回的结果格式与 get_market_data_ex 一样，但是内容只有之前用 download_history_data 下载到本地的数据。
如何同时获取到拼接完整的历史数据和实时行情数据，后续再展开（坑2）。
（内容随时迭代更新中，欢迎常回来看看）