4.1. 下单

4.1.1. SDK 定义

备注

下单接口需要生成一个订单ID,请参考 订单 ID 的介绍

@abc.abstractmethod
def place_order(self, order_id: str, security_type: SecurityType, symbol: str, exchange: str,
                side: OrderSide, currency: Currency, quantity: int, price: float = 0,
                order_type: OrderType = OrderType.LIMIT, tif: TimeInForce = TimeInForce.DAY,
                force_only_rth: bool = True, stop_price: float = 0, parent: str = None, order_id_type: OrderIdType = OrderIdType.CLIENT):
    """下单
    :param order_id: 订单 ID
    :param security_type: 证券类型,参见数据字典:SecurityType
    :param symbol: 证券代码
    :param exchange: 交易所代码
    :param side: 交易方向,参见:数据字典OrderSide
    :param currency: 币种,参见:数据字典Currency
    :param quantity: 交易数量 ,最小为1
    :param price: 限价下单必传,市价下单传任何均为0
    :param order_type: 订单类型,参见:数据字典OrderType
    :param tif: 订单有效期,参见:数据字典TimeInForce
    :param force_only_rth: 是否仅限盘中交易
    :param stop_price: 触发价
    :param parent: 父订单 ID
    :param order_id_type: 订单 ID 类型, CLIENT 默认值/代表API订单ID,SNB代表雪盈订单ID
    :return:
        {
          "msg": null,
          "result_code": "60000",
          "result_data": {
            "id": "123123123",
            "memo": "",
            "snb_order_id": "5587483178948816",
            "status": "REPORTED"
          }
        }
    """
    pass

请求参数

参数名

类型

描述

是否必须

默认值

id

string

订单 ID,数字字母组合,1-20 位 订单 ID 的介绍

account_id

string

账户 ID

security_type

enum

证券类型 SecurityType

symbol

string

证券代码

exchange

string

市场,(使用空字符串,将自动选择最优交易所)

order_type

enum

订单类型 OrderType

side

enum

买卖方向 OrderSide

currency

enum

币种 Currency

quantity

int

委托数量

price

double

委托价格,不传默认为 0

0

tif

enum

订单有效期 TimeInForce

DAY

rth

boolean

仅限盘中交易

false

order_id_type

enum

订单 ID 类型 OrderIdType

NONE

trading_hours

enum

指定交易时段 TradingHours

NONE

返回值

参数名

类型

描述

是否必须

默认值

id

string

订单 ID

memo

string

备注

status

enum

订单状态 OrderStatus

snb_order_id

string

第三方订单 ID

备注

可以为主订单附加1或2个子订单

备注

当主订单成交后,子订单会被激活对应数量,主订单与子订单数量需要一致

备注

子订单成交时,同组的其他子订单会被撤销,即同一个主订单的两个子订单会互斥

备注

当主订单被撤后,子订单也会被撤销

备注

当使用 trading_hours 参数时,rth参数将失效。

4.1.2. 示例