One Trading API
REST APIWebSocket API
REST APIWebSocket API
  1. Futures
  • Public
    • Currencies
      GET
    • Instruments
      GET
    • Candlesticks
      GET
    • Fee Groups
      GET
    • Order Book
      GET
    • Market Ticker
      GET
    • Market Ticker For Instrument
      GET
    • Time
      GET
  • Trading
    • Balances
      GET
    • Fees
      GET
    • Get Orders
      GET
    • Create Order
      POST
    • Get Order by Order ID
      GET
    • Get Order by Client ID
      GET
    • Cancel All Orders
      DELETE
    • Cancel Order by Order ID
      DELETE
    • Cancel Order by Client ID
      DELETE
    • Get Trades for Order
      GET
    • Get Trades
      GET
    • Get Trade by Trade ID
      GET
  • Futures
    • Introduction
    • Funding Rate Methodology
    • Current Funding Rate
      GET
    • Funding Rate History
      GET
    • Futures Portfolio Summary
      GET
    • Get Futures Open Positions
      GET
  1. Futures

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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.onetrading.com/fast/v1/account/futures/positions?instrument_code=BTC_EUR_P'
Response Response Example
{
  "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"
    }
  ]
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
instrument_code
string 
optional
Optional instrument code to get open futures positions for.
Example:
BTC_EUR_P

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.
Previous
Futures Portfolio Summary
Built with