Python SDK 使用示例

SDK 的方法与下表中的接口一一对应。方法与本文档的 /docs/<接口> 页面同源,接口变更后重跑文档生成脚本即可同步。

初始化

Python
from databull import DataBull

# api_key 与 base_url 均按实际部署填写
client = DataBull(api_key="YOUR_API_KEY", base_url="https://YOUR_API_HOST")

常用示例

指数历史行情
result = client.get_index_history(index_code="000001", start_date="20260101", end_date="20260630")
美股指数历史行情
result = client.get_us_index_history(index_code="I:SPX", period="d")
美股指数列表
result = client.get_us_index_list(quote_ready_only=True, page=1, page_size=100)
美股指数搜索
result = client.search_us_index(keyword="GSPC", limit=20)
A股股票列表
result = client.get_stock_list()
A股历史行情
result = client.get_history(symbol="600519", start_date="20260101", end_date="20260630", period="d", adj="back")
个股基本信息
result = client.get_stock_info(symbol="600519")
个股财务数据
result = client.get_stock_financial_data(symbol="600519", start_date="2025-01-01", end_date="2026-06-30", report_type="Income")
上市公司公告
result = client.get_stock_announcements(stock="600519", keyword="转债", start_date="20260101", end_date="20260630")
个股技术因子目录
result = client.get_stock_factor_catalog()
个股因子全市场截面快照
result = client.get_stock_factor_snapshot(factor_name="mom_20", trade_date="2026-10-09")
个股因子最新值
result = client.get_stock_factor_latest(symbol="600519")
ETF 列表
result = client.get_etf_list()
ETF 基本信息
result = client.get_etf_info(symbol="510300")
ETF 成分股
result = client.get_etf_composition(symbol="510300")
反查个股所属 ETF
result = client.get_etf_holding_etfs(symbol="600519")
ETF 历史行情
result = client.get_etf_history(symbol="510300", start_date="20260101", end_date="20260630", adj="back")
美股股票列表
result = client.get_us_stock_list(page=1, page_size=100)
港股股票列表
result = client.get_hk_stock_list(page=1, page_size=100)
个股实时 Tick
result = client.get_last_tick(symbol="600519", tick_type="stock")
交易日历
result = client.get_trading_calendar(market="cn", year=2026)
宏观经济指标清单
result = client.list_macro_indicators()
宏观经济指标序列
result = client.get_macro_indicator(indicator_code="CN_CPI_YOY")

全部方法

方法接口说明
get_index_history()/cn/index/history指数历史行情
get_us_index_history()/us/index/history美股指数历史行情
get_us_index_list()/us/index/list美股指数列表
search_us_index()/us/index/search美股指数搜索
get_stock_list()/cn/stocksA股股票列表
get_history()/cn/stock/historyA股历史行情
get_stock_info()/cn/stock/info个股基本信息
get_stock_financial_data()/cn/stock/financial_data个股财务数据
get_stock_announcements()/cn/stock/announcements上市公司公告列表
get_stock_factor_catalog()/cn/stock/factors个股技术因子目录
get_stock_factor_snapshot()/cn/stock/factors/snapshot个股因子全市场截面快照
get_stock_factor_latest()/cn/stock/factors/latest单只个股全部因子最新值
get_etf_list()/cn/etfs/ETF 列表
get_etf_info()/cn/etfs/infoETF 基本信息
get_etf_composition()/cn/etfs/etf_compositionETF 成分股
get_etf_holding_etfs()/cn/etfs/by_stock反查个股所属 ETF
get_etf_history()/cn/etf/historyETF 历史行情
get_us_stock_list()/us/stocks美股股票列表
get_hk_stock_list()/hk/stocks港股股票列表
get_last_tick()/cn/stock/tick个股实时 Tick
get_trading_calendar()/cn/tick/trading_calendar查询交易日历
list_macro_indicators()/macro/indicators宏观经济指标清单
get_macro_indicator()/macro/indicator宏观经济指标序列