order(订单)相关
引擎使用文档
order(security, amount, style=OrderStyle)
发送所指定手数amount的给定证券security的订单。从所使用的style参数推断订单类型。如果仅传入security和amount参数,则将订单视为为市价订单。
参数:
- security:证券,可以是证券代码或者Security对象。
- amount:交易手数,整数。正值意味着买入,负值意味着卖出。
- OrderStyle:(可选)指定订单样式,默认值为市价订单。可用的订单样式有:
- style = MarketOrder(exchange)
- style = StopOrder(stop_price,exchange)
- style = LimitOrder(limit_price,exchange)
- style = StopLimitOrder(limit_price = price1,stop_price = price2,exchange)
单击此处查看exchange的示例。
返回:
订单ID。
order_value(security,value,style = OrderStyle)
根据给定价值value而不是给定的交易手数下单。传入负值代表卖出。交易手数总是被截断为整数手。
例:
发送价值达¥10000的股票代码000002所代表股票的订单:order_value(symbol('000002'),10000)。如果000002的价格是每股15元,这将购买6手(600股),小数部分手数将被截断(不考虑滑点和交易成本)。
参数:
- security:证券,可以是证券代码或者Security对象。
- value:证券的价值,据此计算交易手数,并截断为整数手。正值意味着买入,负值意味着卖出。
- OrderStyle:(可选)指定订单样式,默认值为市场订单。可用的订单样式有:
- style = MarketOrder(exchange)
- style = StopOrder(stop_price,exchange)
- style = LimitOrder(limit_price,exchange)
- style = StopLimitOrder(limit_price = price1,stop_price = price2,exchange)
单击此处查看exchange的示例。
返回:
订单ID。
order_percent(security,percent,style = OrderStyle)
发送对应于当前资产净值的给定百分比(即头寸总市值和期末现金余额的总和)的订单。传入负百分比值表示卖出。订单总是被截断为全股。百分比必须以小数表示(0.50表示50%)。
例:
order_percent(symbol('000002'),0.5)将买入价值当前投资组合50%的股票000002。如果000002是15元/股,投资组合价值是100000元,这将购买33手(不考虑滑点和交易成本)。
参数:
- security:证券,可以是证券代码或者Security对象。
- percent:百分比。正值意味着买入,负值意味着卖出。
- OrderStyle:(可选)指定订单样式,默认值为市场订单。可用的订单样式有:
- style = MarketOrder(exchange)
- style = StopOrder(stop_price,exchange)
- style = LimitOrder(limit_price,exchange)
- style = StopLimitOrder(limit_price = price1,stop_price = price2,exchange)
单击此处查看exchange的示例。
返回:
订单ID。
order_target(security, amount, style=OrderStyle)
发送订单以将security的头寸调整为目标手数amount。如果账户中没有对应头寸,则会按整个目标amount下单。如果已有对应头寸,则对目标手数和当前持仓量之间的差额进行下单。传入负目标手数值将建立等于指定负数的空头头寸。
参数:
- security:证券,可以是证券代码或者Security对象。
- amount:目标手数,整数。正值意味多头头寸,负值意味着空头头寸。(股票中若传入负值将报错)
- OrderStyle:(可选)指定订单样式,默认值为市价订单。可用的订单样式有:
- style = MarketOrder(exchange)
- style = StopOrder(stop_price,exchange)
- style = LimitOrder(limit_price,exchange)
- style = StopLimitOrder(limit_price = price1,stop_price = price2,exchange)
单击此处查看exchange的示例。
返回:
订单ID。
order_target_value(security,value,style = OrderStyle)
根据目标头寸价值value计算目标头寸手数,并截取整数手。正值意味多头头寸,负值意味着空头头寸。然后按order_target中的方式下达订单。
参数:
- security:证券,可以是证券代码或者Security对象。
- value:目标头寸价值,据此计算目标头寸手数,并截断为整数手。正值意味多头头寸,负值意味着空头头寸。
- OrderStyle:(可选)指定订单样式,默认值为市场订单。可用的订单样式有:
- style = MarketOrder(exchange)
- style = StopOrder(stop_price,exchange)
- style = LimitOrder(limit_price,exchange)
- style = StopLimitOrder(limit_price = price1,stop_price = price2,exchange)
单击此处查看exchange的示例。
返回:
订单ID。
order_target_percent(security,percent,style = OrderStyle)
根据目标头寸占当前账户净值百分比数计算目标头寸手数,并截取整数手。正值意味多头头寸,负值意味着空头头寸。然后按order_target中的方式下达订单。
参数:
- security:证券,可以是证券代码或者Security对象。
- percent:目标头寸价值占当前账户净值百分比数。正值意味多头头寸,负值意味着空头头寸。
- OrderStyle:(可选)指定订单样式,默认值为市场订单。可用的订单样式有:
- style = MarketOrder(exchange)
- style = StopOrder(stop_price,exchange)
- style = LimitOrder(limit_price,exchange)
- style = StopLimitOrder(limit_price = price1,stop_price = price2,exchange)
单击此处查看exchange的示例。
返回:
订单ID。
cancel_order(order)
尝试取消指定的订单。取消将以异步的方式进行。
参数:
- order: 可以是字符串类型的order_id或是order对象本身.
返回:
None
如果security为None, 返回所有活跃状态(未完全成交且仍有效)的订单. 如果指定了security, 返回该品种的处于活跃状态的订单
参数
- security: Security对象或证券代码
返回:
如果指定了security,返回一个有序字典,键为订单ID,值为Order对象,订单按下单时间顺序排列。
如果security为None, 返回一个以证券代码为键,值为对应品种的未完成订单有序字典。
get_order(order_id)
返回给定order_id的订单.
参数:
返回:
返回订单对象