KB / ARTICLE

核心API-合约信息查询

策略文档 · 期货版修订 R1发布于 2026-10-10

本文汇总期魔方期货策略中与合约信息查询相关的 API,包括品种手续费查询与品种期权合约查询。

get_commission(symbol) — 获取品种手续费

查询品种当前的手续费率和最低手续费。

输入参数

参数 参数名称 参数类型 是否必填 描述
symbol 完整合约代码 str 是 如 ru2501(橡胶2501)

返回值 返回一个字典,字典详细参数如下

参数 参数名称 参数类型 描述
BizType 业务类型 str
BrokerID 经纪公司代码 str
CloseRatioByMoney 平仓手续费率 float 按金额计算
CloseRatioByVolume 平仓手续费率 float 按成交量计算
CloseTodayRatioByMoney 平今仓手续费率 float 按金额计算
CloseTodayRatioByVolume 平今仓手续费率 float 按成交量计算
ExchangeID 交易所ID str
InstrumentID 合约ID str
InvestorID 投资者ID str
InvestorRange 投资者范围 str
OpenRatioByMoney 开仓手续费率 float 按金额计算
OpenRatioByVolume 开仓手续费率 float 按成交量计算

接口案例

def on_tick(context):
    # 获取短纤(PF603)的手续费
    commission = get_commission("PF603")

数据示例

{'BizType': '', 'BrokerID': '9999', 'CloseRatioByMoney': 0.0, 'CloseRatioByVolume': 3.0, 'CloseTodayRatioByMoney': 0.0, 'CloseTodayRatioByVolume': 3.0, 'ExchangeID': '', 'InstrumentID': 'PF', 'InvestUnitID': '', 'InvestorID': '00000000', 'InvestorRange': '1', 'OpenRatioByMoney': 0.0, 'OpenRatioByVolume': 3.0, 'reserve1': 'PF'}

get_option_in_instrument(symbol) — 获取品种期权合约

给定一个品种,返回该品种所有可交易的期权合约列表。

输入参数

参数 参数名称 参数类型 是否必填 描述
symbol 完整合约代码 str 是 如 ru2501(橡胶2501)

接口案例

def on_tick(context):
    # 获取玉米(c2603)的期权合约列表
    option = get_option_in_instrument("c2603")
    if option["data"] not is None:
        option_symbol = option["data"]

数据示例

# 成功获取后返回的字典
{'status': 'success', 'data': ['c2603-P-2140', 'c2603-P-2340', ....., 'c2603-P-2300', 'c2603-P-2280', 'c2603-P-2180', 'c2603-C-1980', 'c2603-C-2400', 'c2603-C-2440']}
# 没有期权的返回的数据结构:
{'status': 'success', 'data': None}

相关阅读

  • [核心API 交易指令]
  • [核心API 辅助功能]
已复制到剪贴板
策略文档 · 期货版修订 R1

返回策略文档 · 期货版板块

评论