actionenumобязательный
What to do — place: place an order (needs: category, symbol, qty, side, orderType) | cancel: cancel an order | modify: modify an order | cancelAll: cancel all orders (destructive) (needs: category) | countdownCancel: dead-man's-switch auto-cancel (needs: countdown) | open: list open orders | detail: one order's detail | history: historical orders (needs: category) | fills: fill history | maxOpen: max openable size (needs: category, symbol, orderType, side). Pass orders to batch place/cancel/modify.
autoCancelenum
Will the original order be canceled if the order modification fails yes: Cancel no: Not cancel（default）
categoryenum
Product category, e.g. SPOT or USDT-FUTURES.
clientOidstring
Idempotency key. Auto-generated for a single place when omitted (P7).
confirmboolean
Required to execute cancelAll (destructive).
countdownstring
Reconnect Window - Unit: seconds - Positive integer, range: [5, 60]. The minimum countdown is 5 second, and the maximum is 60 seconds. Filling in 0 cancels the countdown order cancellation function.
cursorstring
Cursor Pagination is implemented by omitting the cursor in the first query and applying the cursor from the previous query for subsequent pages
dryRunboolean
Preview the write without sending it.
endTimestring
End timestamp A Unix timestamp in milliseconds e.g.,1597026383085
fetchAllboolean
history/fills only: walk the cursor to bounded completion (returns { items, pages, truncated }).
fieldsany
Optional list (array or comma-separated string) of fields to keep on each returned row.
limitstring
Limit per page Default:100. Maximum:100
orderIdstring
Target order id for cancel/modify/detail.
ordersunknown[]
Array of order/cancel/modify objects. When present, place/cancel/modify route to the batch endpoint automatically.
orderTypeenum
limit or market.
posSideenum
Position side long/short This field is required in hedge-mode position. Available only for futures
pricestring
Order price (limit orders).
qtystring
Order size/quantity (the v3 API field name).
reduceOnlyenum
Reduce-only identifier yes/no, default no; yes indicates that your position may only be reduced in size upon the activation of this order
sideenum
buy or sell.
slLimitPricestring
Stop-Loss Strategy Order Execution Price This field is only valid for limit orders (when slOrderType=limit); it is ignored for market orders.
slOrderTypeenum
Stop-Loss Trigger Strategy Order Type limit: Limit Order market: Market Order
slTriggerByenum
Preset Stop-Loss Trigger Type market: Market Price mark: Mark Price If not filled in, the default value is market price Note: This field is only valid for the contract business lines: USDT-Futures, COIN-Futures, and USDC-Futures
startTimestring
Start timestamp A Unix timestamp in milliseconds e.g.,1597026383085
stopLossstring
Preset Stop-Loss Trigger Price
stpModeenum
STP Mode(Self Trade Prevention) none: not setting STP(default) cancel_taker: cancel taker order cancel_maker: cancel maker order cancel_both: cancel both of taker and maker orders
symbolstring
Trading pair, e.g. BTCUSDT.
takeProfitstring
Preset Take-Profit Trigger Price
timeInForceenum
Time in force ioc Immediate or cancel. It must be executed immediately, with any unfilled portion canceled. fok Fill or kill. It must be fully executed immediately, or it is canceled entirely. gtc Good 'til canceled. It remains active until it is either filled or manually canceled. post_only Post only. It will only be added to the order book as a maker. This field is required when orderType is limit. If omitted, it defaults to gtc
tpLimitPricestring
Take-Profit Strategy Order Execution Price This field is only valid for limit orders (when tpOrderType=limit); it is ignored for market orders.
tpOrderTypeenum
Take-Profit Trigger Strategy Order Type limit: Limit Order market: Market Order
tpTriggerByenum
Preset Take-Profit Trigger Type market: Market Price mark: Mark Price If not specified, the default value is market price Note: This field is only valid for the contract business lines: USDT-Futures, COIN-Futures, and USDC-Futures.
viewenum
summary (default) trims null fields to save tokens; full returns the untouched payload.
