Skip to content

Account Balance

Endpoint: /v1/futures/wallet

Request Parameters

Not required

Method: GET

Example

Bash
curl -X GET "https://oapi.websea.com/v1/futures/wallet" \
  -H "Token: YOUR_TOKEN" \
  -H "Nonce: 1700000000_abcd1" \
  -H "Signature: GENERATED_SIGNATURE"

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
asset Yes string USDT Asset
balance Yes string 1000 Total balance (excluding unrealized PnL)
unPnl Yes string 800 Unrealized PnL
avail Yes string 100 Available balance
hold Yes string 600 Margin used for open positions
frozen Yes string 500 Margin frozen by open orders
updateTime Yes number 1502448920 Last update time (Unix timestamp)

Response Example

JSON
{
  "errno": 0,
  "errmsg": "Succeeded",
  "result": [
    {
      "asset": "USDT",
      "balance": "1000",
      "unPnl": "800",
      "avail": "100",
      "hold": "600",
      "frozen": "500",
      "updateTime": 1502448920
    }
  ]
}