Query Current Positions

Endpoint: /v1/futures/position

Request Parameters

Required

Method: GET

Example

Bash

curl -X GET "https://oapi.websea.com/v1/futures/position?symbol=ETH-USDT&is_full=1" \
  -H "Token: YOUR_TOKEN" \
  -H "Nonce: 1700000000_abcd1" \
  -H "Signature: GENERATED_SIGNATURE"

Query Parameters

Parameter	Required	Type	Example	Description
symbol	No	string	ETH-USDT	Trading pair. If omitted, all positions will be returned
is_full	No	int	1	Margin mode: 1 isolated margin, 2 cross margin

Response Parameters

Parameter	Required	Type	Example	Description
errno	Yes	int	0	Status code
errmsg	Yes	string	success	Status message
result	Yes	array	See example	Result data

Result Fields

Parameter	Required	Type	Example	Description
type	Yes	int	1	Position side: 1 long, 2 short
symbol	Yes	string	ETH-USDT	Trading pair
lever_rate	Yes	int	10	Leverage multiplier
amount	Yes	string	10	Position size
profit	Yes	string	10	Realized PnL
open_price_avg	Yes	string	0.3	Average entry price
bood	Yes	string	6	Frozen margin (USDT)
contract_frozen	Yes	string	5	Frozen contracts
settle_rate	Yes	string	0.1	Current funding/settlement fee
equity	Yes	string	3.4	Account equity (USDT)
avail	Yes	string	20	Available balance (USDT)
bond_rate	Yes	string	1.1	Margin ratio
liquidation_price	Yes	string	0.9	Liquidation price
avail_amount	Yes	string	50	Closable quantity (contracts)
un_profit	Yes	string	0	Unrealized PnL

Response Example

JSON

{
    "errno": 0,
    "errmsg": "success",
    "result": [
        {
            "type": 1,
            "symbol": "ETH-USDT",
            "lever_rate": 10,
            "amount": "10",
            "profit": "10",
            "open_price_avg": "0.3",
            "bood": "6",
            "contract_frozen": "5",
            "settle_rate": "0.1",
            "equity": "3.4",
            "avail": "20",
            "bond_rate": "1.1",
            "liquidation_price": "0.9",
            "avail_amount": "50",
            "un_profit": "0"
        }
    ]
}