下委托单 - INSERT_ORDER¶
-
INSERT_ORDER
(order_param)¶ - 发送委托单
Arguments: - order_param (object) -- 参数对象。
Returns: order 对象。
参数说明¶
order_param 中必须包括的字段有(多余的字段不会影响下单):
name | type | option | memo | example |
---|---|---|---|---|
symbol | string | 必填 | 合约标识,关于 symbol 的说明 | CFFEX.TF1803 |
direction | string | 必填 | 买卖 "BUY"|"SELL" | SELL |
offset | string | 必填 | 方向 "OPEN"|"CLOSE" | OPEN |
volume | number | 必填 | 手数 | 4 |
limit_price | number | 必填 | 限价价格 | 96.250 |
order_id | string | 可选 | 指定 order_id | |
unit_id | string | 可选 | 关于 order_id 和 unit_id 的说明 |
Attention
如果参数中指定了 order_id,那么用户委托单号就是指定的 order_id,但是用户指定时需要保证不同的委托单 order_id 不重复;
如果没有指定 order_id,但是指定了 unit_id,那么委托单号就是 unit_id.random_string;
如果 order_id 和 unit_id 都没有指定,那么委托单号就由系统指定,保证不重复。
用法示例¶
const TQ = new TQSDK();
let order = TQ.INSERT_ORDER({
symbol: "SHFE.cu1810",
direction: "BUY",
offset: "OPEN",
volume: 2,
limit_price: 2100,
unit_id: "abc",
});
返回数据结构示例¶
{
"order_id": "DK.djkIjXj", //委托单ID, 在每个会话中唯一
"exchange_id": "SHFE", //交易所
"instrument_id": "cu1810", //合约代码
"direction": "BUY", //下单方向
"offset": "OPEN", //开平标志
"volume_orign": 6, //总报单手数
"volume_left": 3, //未成交手数
"price_type": "LIMIT", //价格类型
"limit_price": 45000, //委托价格, 仅当 price_type = LIMIT 时有效
"status": "ALIVE", //委托单状态, ALIVE=有效, FINISHED=已完
}