深入框架
pythongo.core

MarketCenter

数据中心 API 类

提供一些扩展数据,供用户使用

get_kline_data()

获取 K 线数据

此 API 有调用限制,请合理使用,否则会永久封禁 IP

参数:

参数名类型描述默认值
exchangestr交易所代码必填
instrument_idstr合约代码必填
styleKLineStyleTypeK 线周期, KLineStyle 枚举值KLineStyle.M1
countint查询的 K 线数量(最大 1440),正值获取基准时间戳后的数据,负值为之前-1440
originint基准时间戳(毫秒)None
start_timeTypeDateTimeK 线起始时间None
end_timeTypeDateTimeK 线结束时间None
simplybool极简 K 线, 只返回带有 OHLC 和时间的 K 线True

返回:

类型描述
list[dict]K 线数据

注意:

使用 start_timeend_time 可以获取一个时间区间的 K 线,但同时这样会忽略 countorigin 参数

也就是说要么按时间区间获取,要么按 K 线数量获取 K 线数据

get_kline_data_by_day()

按天数(交易日)获取 K 线数据

此 API 有调用限制,请合理使用,否则会永久封禁 IP

参数:

参数名类型描述默认值
exchangestr交易所代码必填
instrument_idstr合约代码必填
day_countint查询 N 天的数据,正值获取基准时间戳后的数据,负值为之前必填
originint基准时间戳(毫秒)None
styleKLineStyleTypeK 线周期,KLineStyle 枚举值,仅支持 M1, M5, M15, M30, H1KLineStyle.M1
simplybool极简 K 线, 只返回带有 OHLC 和时间的 K 线True

返回:

类型描述
list[dict]K 线数据

get_dominant_list()

获取交易所的主连合约列表

此 API 有调用限制,请合理使用,否则会永久封禁 IP

参数:

参数名类型描述默认值
exchangestr交易所代码必填

返回:

类型描述
list[str]主连合约列表

get_instrument_trade_time()

查询带交易日的合约交易时段

此 API 有调用限制,请合理使用,否则会永久封禁 IP

参数:

参数名类型描述默认值
exchangestr交易所代码必填
instrument_idstr合约代码必填
instantint基准时间戳(毫秒)None

返回:

类型描述
dict合约交易时段信息

get_product_trade_time()

查询品种的交易时段信息

此 API 有调用限制,请合理使用,否则会永久封禁 IP

参数:

参数名类型描述默认值
exchangestr交易所代码必填
product_idstr品种代码,也可填写合约代码必填
trading_daystr品种交易日,格式为 `%Y%m%d`,例如:20240101None

返回:

类型描述
dict品种交易时段信息

get_avl_close_time()

从缓存中获取合约可使用的收盘时间序列,如无缓存, 则获取不到任何数据

参数:

参数名类型描述默认值
instrument_idstr合约代码必填

返回:

类型描述
list[datetime]在当前时间之后的收盘时间序列

get_next_gen_time()

根据提供的合约信息、时间和 K 线周期,获取下一根 K 线生成时间

参数:

参数名类型描述默认值
exchangestr交易所代码必填
instrument_idstr合约代码必填
tick_timedatetimetick 时间必填
styleKLineStyleTypeK 线周期, KLineStyle 枚举值必填

返回:

类型描述
datetime下一根 K 线生成时间

KLineStyle

K 线周期

枚举类型,分别有以下枚举值

风格分钟数备注
M111 分钟
M222 分钟
M333 分钟
M444 分钟
M555 分钟
M101010 分钟
M151515 分钟
M303030 分钟
M454545 分钟
H1601 小时
H21202 小时
H31803 小时
H42404 小时
D11440日线

KLineStyleType

K 线周期类型

type 类型,用于类型注释