财务数据

财务报表数据（资产负债表、利润表、现金流量表等）查询与下载。

财务数据客户端方法集合，对应 /api/financial/* 端点。

get_financial_data(stocks: list[str], tables: list[str] | None = None, start_time: str = '', end_time: str = '', report_type: str = 'report_time') -> dict

获取上市公司财务报表数据。

底层调用 xtdata.get_financial_data()，返回指定股票在时间范围内的 财务报表数据。需要先通过 download_financial() 下载数据到服务端。

参数：

名称	类型	描述	默认
stocks	list[str]	股票代码列表，如 ["000001.SZ", "600519.SH"]	必需
tables	list[str] | None	财务表名列表，如 ["Balance", "Income"]；为 None 时返回全部	None
start_time	str	开始时间，格式 "20230101"	''
end_time	str	结束时间	''
report_type	str	报表时间类型: - "report_time": 按报告期筛选 - "announce_time": 按公告日期筛选	'report_time'

返回：

类型	描述
dict	嵌套字典 {stock: {table: [records]}}

download_financial(stocks: list[str], tables: list[str] | None = None, start_time: str = '', end_time: str = '') -> dict

触发服务端异步下载财务数据。

底层调用 xtdata.download_financial_data()，向行情服务器请求 下载指定股票的财务报表数据到服务端本地缓存。

参数：

名称	类型	描述	默认
stocks	list[str]	股票代码列表	必需
tables	list[str] | None	财务表名列表，为空则下载全部表	None
start_time	str	开始时间	''
end_time	str	结束时间	''

返回：

类型	描述
dict	下载任务状态信息

get_financial_data_ori(stocks: list[str], tables: list[str] | None = None, start_time: str = '', end_time: str = '', report_type: str = 'report_time') -> dict

获取原始格式财务数据。

参数：

名称	类型	描述	默认
stocks	list[str]	股票代码列表	必需
tables	list[str] | None	财务表名列表，为 None 时返回全部	None
start_time	str	开始时间	''
end_time	str	结束时间	''
report_type	str	报表时间类型	'report_time'

返回：

类型	描述
dict	原始格式财务数据