CFD Trade
CFD — Trade
Place CFD Order
Rate limit: 1/sec/UID
Permission: UTA trade (read & write)
This endpoint is used to place an order on a CFD account.
Place CFD Order › Request Parameters
symbolTrading pair name
orderTypeOrder typelimit: Limit ordermarket: Market order
sideTrade sidebuy: Buysell: Sell
qtyOrder quantity
priceOrder price
Required when orderType=limit
The price must be an integer multiple of the trading pair's precision
takeProfitTake-profit price
The price must be an integer multiple of the trading pair's precision
stopLossStop-loss price
The price must be an integer multiple of the trading pair's precision
Place CFD Order › Response Parameters
Successful response
codemsgrequestTimetrxIdRequest ID
Modify CFD Order
Rate limit: 1/sec/UID
Permission: UTA trade (read & write)
This endpoint is used to modify an order on a CFD account.
Modify CFD Order › Request Parameters
orderIdOrder ID
priceOrder price
Required when orderType=limit
takeProfitTake-profit price
stopLossStop-loss price
Modify CFD Order › Response Parameters
Successful response
codemsgrequestTimeorderIdOrder ID
Cancel All CFD Orders
Rate limit: 1/sec/UID
Permission: UTA trade (read & write)
This endpoint is used to cancel all orders on a CFD account.
Cancel All CFD Orders › Request Parameters
symbolTrading pair name
If not provided, all orders are canceled
If symbol is provided, only orders for the specified trading pair are canceled
Cancel All CFD Orders › Response Parameters
Successful response
codemsgrequestTimedatanull
Close CFD Positions
Rate limit: 10/sec/UID
Permission: UTA trade (read & write)
This endpoint is used to close positions on a CFD account. Only market-price closing is currently supported.
Close CFD Positions › Request Parameters
positionIdPosition ID
Can be obtained via the position list endpoint
qtyOrder quantity
Close CFD Positions › Response Parameters
Successful response
codemsgrequestTimedatanull
Close All CFD Positions
Rate limit: 1/sec/UID
Permission: UTA trade (read & write)
This endpoint is used to close all positions on a CFD account.
Close All CFD Positions › Request Parameters
symbolTrading pair name
If not provided, all positions are closed
If symbol is provided, only positions for the specified trading pair are closed
Close All CFD Positions › Response Parameters
Successful response
codemsgrequestTimedatanull
Get CFD Unfilled Orders
Rate limit: 10/sec/UID
Permission: UTA trade (read-only)
This endpoint is used to query unfilled orders on a CFD account.
Request Parameters
symbolTrading pair name
subUidSub-account UID
Used to query a sub-account's unfilled orders
Get CFD Unfilled Orders › Response Parameters
Successful response
codemsgrequestTimesymbolTrading pair name
orderTypeOrder typelimit: Limit ordermarket: Market order
sideTrade sidebuy: Buysell: Sell
priceOrder price
qtyOrder quantity
takeProfitTake-profit price
stopLossStop-loss price
trxIdRequest ID
orderIdOrder ID
Get CFD Order History
Rate limit: 10/sec/UID
Permission: UTA trade (read-only)
This endpoint is used to query historical orders on a CFD account.
The query span per request must not exceed 30 days. The maximum lookback period is 90 days.
Request Parameters
symbolTrading pair name
subUidSub-account UID
Used to query a sub-account's historical orders
startTimeStart time, Unix millisecond timestamp
endTimeEnd time, Unix millisecond timestamp
limitNumber of entries per page
Default: 10, range [1, 50]
For the first page, the number of entries returned may be greater than the specified limit
pageNoPage number
cursorCursor
Not required for the first page
Required from the second page onward: pass the orderId of the last record from the previous page's response
Get CFD Order History › Response Parameters
Successful response
codemsgrequestTimeList
Get CFD Current Positions
Rate limit: 10/sec/UID
Permission: UTA trade (read-only)
This endpoint is used to query real-time position information on a CFD account.
Request Parameters
symbolTrading pair name
If not provided, current positions for all trading pairs are returned
subUidSub-account UID
Used by a master account to query a sub-account's position list
Get CFD Current Positions › Response Parameters
Successful response
codemsgrequestTimepositionIdPosition ID
symbolTrading pair name
orderTypeOrder typelimit: Limit ordermarket: Market order
sideTrade sidebuy: Buysell: Sell
qtyOrder quantity
openPriceOpening price
takeProfitTake-profit price
stopLossStop-loss price
interestOvernight interest
unrealizedPnlUnrealized profit and loss
totalProfitTotal profit
Total profit = Overnight interest + Unrealized profit and loss