Get current position

GET 
/positions

Returns the position for the specified asset. Expressed as a positive (long position) or negative (short position) value.

info

This is a private endpoint. To send requests, you need to authenticate.

Rate limit weight points: 5

Request

Query Parameters

symbol string
The list of assets for which to return the balance. If not specified, returns the non-zero positions for all assets.
Example: BTC,EUR

Responses

200

The request was successful.

application/json

Schema

Schema

assets object[]
Array [
symbolstring
The asset for which the position is returned. Always an uppercase cryptocurrency symbol.
Example: ETH
positionstring
Indicates if the current position is long or short. The short position represents the amount of the unsettled loan.
Example: -105.85
shortLimitstring
The maximum allowed asset amount for a short position within 24 hours.
Example: -150
reservations object[]
The reserved amount of the asset, for example for withdrawals.
Array [
typestring
The type of reservation.
Example: withdrawal
amountstring
The reserved amount.
Example: 500.00
]
updatedAtinteger<int64>
The Unix timestamp in nanoseconds when the position was last updated.
Cannot be used to correlate with the order events.
Example: 1752139200000000000
]

Example (body)

{
  "assets": [
    {
      "symbol": "ETH",
      "position": "-105.85",
      "shortLimit": "-150",
      "reservations": [
        {
          "type": "withdrawal",
          "amount": "500.00"
        }
      ],
      "updatedAt": 1752139200000000000
    }
  ]
}

4XX

For error codes, see Handle errors.