Skip to main content
GET
Retrieve account earnings (P&L)

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

period
enum<string> | null

Predefined period over which earnings are computed. Takes precedence over period_start/period_end when provided.

Available options:
1d,
1w,
1m,
this-month,
3m,
6m,
ytd,
1y,
all
period_start
string<date-time>

The period start (in ISO 8601 format). If omitted, it defaults to the account opening date/time. Note that the period is interpreted as a half-open interval with period_start included and period_end excluded.

Examples:

"period_start=2025-11-12T00:00:00Z"

"period_start=2025-11-12"

period_end
string<date-time>

The period end (in ISO 8601 format). If omitted, it defaults to the current date/time. Note the period is interpreted as a half-open interval with period_start included and period_end excluded.

Examples:

"period_end=2025-11-12T00:00:00Z"

"period_end=2025-11-12"

Response

Successful Response

account
string
required

ID of the account the earnings were computed for.

cash
AccountCashEarnings · object
required

What uninvested foreign-currency cash gained or lost from exchange-rate movements.

currency
enum<string>
required

Reporting currency of the earnings amounts.

Available options:
EUR,
USD,
GBP
fees
string
required

Fees deducted from gross earnings.

gross
string
required

Everything the account earned before fees: today's value minus the net money paid in, with fees added back. Also equals the positions' gross plus the cash gross.

net
string
required

Everything the account earned after fees: gross minus fees.

period_end
string<date-time>
required

End date and time of the earnings period.

Example:

"2026-03-31T23:59:59Z"

period_start
string<date-time>
required

Start date and time of the earnings period.

Example:

"2026-01-01T00:00:00Z"

positions
AccountPositionsEarnings · object
required

What the account's positions earned, with a breakdown of where it came from.