Futures Portfolio Summary

This endpoint provides a real-time summary of a user's futures portfolio on the exchange. It returns details about the current portfolio, including the user's account equity, available margin, margin used and positions. The summary is updated with settlements every minute, ensuring users have the most accurate and up-to-date information about their portfolio.

{ "account_id": "c5157711-6d52-4a8c-bbf7-f20d8a3d21ea", "equity": "962.78283436", "margin_used": "9.156582", "margin_available": "953.62625236", "account_ratio": "105.23348999023438", "maintenance_margin": "16.6353165", "positions": [ { "instrument_code": "BTC_EUR_P", "direction": "LONG", "open_volume": "0.00186", "open_position": "149.2689804", "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-26T10:00:00.000Z" } ] }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200Success

application/json

Body

account_id

string <uuid>

required

The unique identifier for the futures account.

equity

string

required

Total asset value in EUR that can be used as margin for futures positions.

margin_available

string

required

margin_used

string

required

account_ratio

string

required

maintenance_margin

string

required

positions

array [object {10}]

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.

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.

Request

Responses