Getting Started
Public Data
Trading
- POSTPlace order
- DELCancel order
- DELCancel multiple orders
- GETGet order
- GETGet orders
- PUTEdit order
- POSTPlace algo order
- DELCancel algo order
- DELCancel multiple algo orders
- DELCancel all orders by symbol
- GETGet algo order
- GETGet algo orders
- PUTEdit algo order
- GETGet transaction by trade id (last 3 months)
- GETGet transaction history (in the past 2 years)
- GETGet trading fee
- POSTCancel all after
Account
Assets
Futures
Spot Margin
Websocket Streams
curl --request GET \
--url https://api.woox.io/v3/futures/positions \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-signature: <x-api-signature>' \
--header 'x-api-timestamp: <x-api-timestamp>'{
"success": true,
"data": {
"positions": [
{
"symbol": "PERP_BTC_USDT",
"holding": "1.0234",
"positionSide": "BOTH",
"pendingLongQty": "0.0",
"pendingShortQty": "0.0",
"settlePrice": "27903.2",
"averageOpenPrice": "27903.2",
"pnl24H": "0.0",
"fee24H": "0.0",
"markPrice": "27903.2",
"estLiqPrice": "0.0",
"adlQuantile": 1,
"timestamp": 1696663260695
},
...
]
},
"timestamp": 1696663264324
}
Get positions
get positions
curl --request GET \
--url https://api.woox.io/v3/futures/positions \
--header 'x-api-key: <x-api-key>' \
--header 'x-api-signature: <x-api-signature>' \
--header 'x-api-timestamp: <x-api-timestamp>'{
"success": true,
"data": {
"positions": [
{
"symbol": "PERP_BTC_USDT",
"holding": "1.0234",
"positionSide": "BOTH",
"pendingLongQty": "0.0",
"pendingShortQty": "0.0",
"settlePrice": "27903.2",
"averageOpenPrice": "27903.2",
"pnl24H": "0.0",
"fee24H": "0.0",
"markPrice": "27903.2",
"estLiqPrice": "0.0",
"adlQuantile": 1,
"timestamp": 1696663260695
},
...
]
},
"timestamp": 1696663264324
}
{
"success": true,
"data": {
"positions": [
{
"symbol": "PERP_BTC_USDT",
"holding": "1.0234",
"positionSide": "BOTH",
"pendingLongQty": "0.0",
"pendingShortQty": "0.0",
"settlePrice": "27903.2",
"averageOpenPrice": "27903.2",
"pnl24H": "0.0",
"fee24H": "0.0",
"markPrice": "27903.2",
"estLiqPrice": "0.0",
"adlQuantile": 1,
"timestamp": 1696663260695
},
...
]
},
"timestamp": 1696663264324
}
Headers
"abcdef123456"
"signaturestring"
"1718943200000"
Query Parameters
Symbol name
Response
true
timestamp
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The trading pair symbol, e.g., PERP_BTC_USDT.
The current holding quantity of the asset in the position.
The position side, such as 'BOTH' for a long and short position.
BOTH, LONG, SHORT The pending quantity for a long position.
The pending quantity for a short position.
The price at which the position will be settled.
The average price at which the position was opened.
The profit and loss (PnL) for the position in the last 24 hours.
The total fee for the position in the last 24 hours.
The mark price of the position.
The estimated liquidation price of the position.
The ADL quantile, a risk management factor.
The timestamp of the position data in Unix epoch time (milliseconds).