Skip to main content
GET
Get exposure over time

Authorizations

Authorization
string
header
required

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

Query Parameters

account_id
string<uuid>

Trading account ID. Omitted, the window covers every account in the organization

environment
enum<string>
required

Required. Which environment the read covers. Resolved to the organization's accounts in that environment, including disabled and deleted ones, since the ledger stores no environment of its own. Rejected with 400 when it disagrees with the account named alongside it.

Available options:
paper,
live
days
integer<int64>
required

Trailing day count. Clamped to 1..=90 and then to the window the caller's plan grants; a single day is reported as 24 hourly buckets

symbol
string

Filter by symbol. Symbols are normalized to uppercase; a blank value is treated as no filter

Response

Exposure retrieved

Exposure over a trailing window, oldest bucket first.

data
object[]
required

One entry per bucket in the window, including buckets in which nothing was held or nothing traded, so the series can be plotted without the caller filling gaps.

granularity
enum<string>
required

Width of one bucket: hour for a single-day window, day otherwise.

Available options:
hour,
day
opening_position_count
integer<int64>
required

Instruments the account had ever held, and not yet flattened, when the window opened.

The series carries positions forward from before its own start, so a non-zero figure here is what makes the left-hand end a real level rather than an artefact of where the scan began.

Required range: x >= 0