Open/Close Futures Position V2

Endpoint: /v2/futures/order/create

Authentication Required

Yes

Method: POST

Example

Bash

curl -X POST "https://oapi.websea.com/v2/futures/order/create " \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Token: YOUR_TOKEN" \
  -H "Nonce: 1700000000_abcd1" \
  -H "Signature: GENERATED_SIGNATURE" \
  -d "symbol=BTC-USDT" \
  -d "trade_type=open" \
  -d "position_side=long" \
  -d "order_type=limit" \
  -d "margin_mode=cross" \
  -d "leverage=50" \
  -d "price=50000" \
  -d "qty=100" \
  -d "qty_type=margin"

Request Parameters

Parameter	Required	Type	Example	Description
symbol	Yes	string	ETH-USDT	Futures trading pair name
trade_type	Yes	string	open	Trade type Open: open Close: close
position_side	Yes	string	long	Position side Long: long Short: short
order_type	Yes	string	limit	Order type Limit: limit Market: market
margin_mode	Yes	string	cross	Margin mode Isolated: isolated Cross: cross
leverage	No	int	10	Leverage (required when trade_type=open, not required when trade_type=close)
price	No	number	1	Order price; not required when order_type=market
qty	Yes	number	100	Order quantity
qty_type	Yes	string	margin	Quantity type Contracts: contract Margin: margin Base currency: base
preset_stop_loss_price	No	number	3	Preset stop-loss price
preset_take_profit_price	No	number	7	Preset take-profit price

Response Parameters

Parameter	Required	Type	Example	Description
errno	Yes	int	0	Response status code
errmsg	Yes	string	ok	Response message
result	Yes	obj	See example	Response data

result Parameters

Parameter	Required	Type	Example	Description
order_id	Yes	string	BL786401542840282676	Order ID

Response Example

JSON

{
  "errno": 0,
  "errmsg": "ok",
  "result": {
    "order_id": "BL786401542840282676"
  }
}