Get Futures Open Positions

Provides all open futures positions for the authenticated user. It provides detailed information about each position, including size, direction, entry price, realised PnL, and the most recent trade and settlement timestamps. Designed for users who want a consolidated view of their active positions, this endpoint ensures that real-time data is available, reflecting the platform’s minute-level settlements.

{ "positions": [ { "instrument_code": "BTC_EUR_P", "direction": "LONG", "open_volume": "0.00186", "open_position": "149.2689804", "maintenance_margin": "16.6353165", "last_settlement": "0.0461466", "mark_price": "80252.14", "realised_pnl": "-0.496713", "quote_currency_balance": "962.78283436", "settlement_currency": "EUR", "last_settlement_timestamp": "2025-03-27T15:50:00.000Z", "account_ratio": "57.9290771484375" } ] }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200Success

application/json

Body

positions

array[object (FuturesPosition) {12}]

required

instrument_code

string

required

The unique identifier for the futures market, e.g. BTC_EUR_P.

direction

string

required

Indicates whether the position is LONG or SHORT.

open_volume

string

required

The current open contract volume for the position.

open_position

string

required

The notional value of the open position, expressed in the settlement currency.

maintenance_margin

string

required

The minimum margin required to keep the position open.

last_settlement

string

required

The profit or loss settled for this position in the last minute settlement cycle, in the quote currency.

mark_price

string

required

The mark price used for calculating the last minutely settlement.

realised_pnl

string

required

The total realised profit or loss for this position, in the quote currency.

quote_currency_balance

string

required

The remaining balance of the account in the quote currency after accounting for open positions and settlements.

settlement_currency

string

required

The currency in which profits and losses for this position are settled.

last_settlement_timestamp

string

required

The timestamp of the last settlement applied to this position.

account_ratio

string

required

The ratio of the account, at the time of last settlement.

Request

Responses