Skip to main content
GET
/
accounts
/
{account_id}
/
positions
List positions
curl --request GET \
  --url https://api.example.com/accounts/{account_id}/positions \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "account": "<string>",
    "status": "open",
    "instrument": {
      "id": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "instrument_type": "<unknown>",
      "trading_status": "buy_sell",
      "trading_increment": "<string>",
      "isin": "<string>",
      "issuer_country": "<string>",
      "issuer_credit_rating": "<string>",
      "minimum_trading_quantity": "<string>",
      "trading_currency": "EUR",
      "pro_traders_only": true,
      "maturity_date": "2023-12-25",
      "supports_automatic_rollover": true,
      "initial_auction_date": "2023-12-25",
      "initial_issue_date": "2023-12-25",
      "latest_auction_date": "2023-12-25",
      "latest_issue_date": "2023-12-25",
      "days_to_maturity": 123,
      "issuer": "<string>"
    },
    "total": "<string>",
    "available_for_trading": "<string>",
    "settled": "<string>",
    "unsettled": "<string>",
    "reserved": "<string>",
    "automatic_rollover": true,
    "can_update_automatic_rollover": true,
    "average_price": "<string>",
    "most_recent_maturity_period": "<string>",
    "ytm": "<string>",
    "total_buy_trades": 123,
    "opened_at": "2023-11-07T05:31:56Z",
    "closed_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "modified_at": "2023-11-07T05:31:56Z",
    "automatic_rollover_cutoff": "2023-12-25"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
account_id
string
required

Query Parameters

​
open_only
boolean
default:false

If true, only open positions are returned.

Response

OK

​
id
string
required
​
account
string
required
​
status
enum<string>
required
Available options:
open,
closing,
closed
​
instrument
Bill · object
required
​
total
string
required
​
available_for_trading
string
required
​
settled
string
required
​
unsettled
string
required
​
reserved
string
required
​
automatic_rollover
boolean
required
​
can_update_automatic_rollover
boolean
required
​
average_price
string | null
required
​
most_recent_maturity_period
string | null
required
​
ytm
string | null
required
​
total_buy_trades
integer
required
​
opened_at
string<date-time>
required
​
closed_at
string<date-time> | null
required
​
created_at
string<date-time>
required
​
modified_at
string<date-time>
required
​
automatic_rollover_cutoff
string<date> | null