跳到主要内容

UM下单(TRADE)

接口描述

UM下单

HTTP请求

POST /papi/v1/um/order

请求权重(Order)

1

请求参数

名称类型是否必需描述
symbolSTRINGYES交易对
sideENUMYES方向
positionSideENUMNO持仓方向,单向持仓模式下非必填,默认且仅可填BOTH;在双向持仓模式下必填,且仅可选择 LONGSHORT
typeENUMYESLIMIT, MARKET
timeInForceENUMNO有效方法
quantityDECIMALNO下单数量
reduceOnlySTRINGNOtruefalse; 非双开模式下默认false;双开模式下不接受此参数
priceDECIMALNO委托价格
newClientOrderIdSTRINGNO用户自定义的订单号,不可以重复出现在挂单中。如空缺系统会自动赋值。必须满足正则规则: ^[\.A-Z\:/a-z0-9_-]{1,32}$
newOrderRespTypeENUMNOACKRESULT,默认 ACK
priceMatchENUMNOOPPONENT/ OPPONENT_5/ OPPONENT_10/ OPPONENT_20/QUEUE/ QUEUE_5/ QUEUE_10/ QUEUE_20;不能与price同时传
selfTradePreventionModeENUMNONONE / EXPIRE_TAKER/ EXPIRE_MAKER/ EXPIRE_BOTH; 默认NONE
goodTillDateLONGNOTIF为GTD时订单的自动取消时间, 当timeInforce为GTD时必传;传入的时间戳仅保留秒级精度,毫秒级部分会被自动忽略,时间戳需大于当前时间+600s且小于253402300799000
recvWindowLONGNO
timestampLONGYES

根据 order type的不同,某些参数强制要求,具体如下:

类型强制要求的参数
LIMITtimeInForce, quantity, price
MARKETquantity
  • newOrderRespType 如果传 RESULT:
    • MARKET 订单将直接返回成交结果;
    • 配合使用特殊 timeInForceLIMIT 订单将直接返回成交或过期拒绝结果。
  • selfTradePreventionMode 仅在 timeInForceIOCGTCGTD时生效.
  • 极端行情时,timeInForceGTD的订单自动取消可能有一定延迟

响应示例

{
"clientOrderId": "testOrder",
"cumQty": "0",
"cumQuote": "0",
"executedQty": "0",
"orderId": 22542179,
"avgPrice": "0.00000",
"origQty": "10",
"price": "0",
"reduceOnly": false,
"side": "BUY",
"positionSide": "SHORT",
"status": "NEW",
"symbol": "BTCUSDT",
"timeInForce": "GTD",
"type": "MARKET",
"selfTradePreventionMode": "NONE", ////订单自成交保护模式
"goodTillDate": 1693207680000, //订单TIF为GTD时的自动取消时间
"updateTime": 1566818724722,
"priceMatch": "NONE"
}