Get Futures Open Positions

Developing

GET

https://api.onetrading.com/fast/v1/account/futures/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.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.onetrading.com/fast/v1/account/futures/positions?instrument_code=BTC_USD_P' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "positions": [
        {
            "instrument_code": "BTC_USD_P",
            "direction": "LONG",
            "open_volume": "0.00186",
            "open_position": "149.2689804",
            "last_settlement": "0.0461466",
            "mark_price": "80252.14",
            "realised_pnl": "-0.496713",
            "settlement_currency": "USD",
            "last_settlement_timestamp": "2026-01-27T15:50:00.000Z"
        }
    ]
}

Futures Portfolio Summary