Skip to main content
GET
/
accounts
/
{account_id}
/
earnings
Retrieve earnings (P&L)
curl --request GET \
  --url https://api.example.com/accounts/{account_id}/earnings \
  --header 'Authorization: Bearer <token>'
{
  "account": "<string>",
  "gross_realized": "<string>",
  "gross_unrealized": "<string>",
  "gross_total": "<string>",
  "net_realized": "<string>",
  "net_unrealized": "<string>",
  "net_total": "<string>",
  "fees": "<string>",
  "currency": "EUR",
  "period_start": "2023-11-07T05:31:56Z",
  "period_end": "2023-11-07T05:31:56Z",
  "position_earnings": [
    {
      "position": "<string>",
      "gross_realized": "<string>",
      "gross_unrealized": "<string>",
      "gross_total": "<string>",
      "gross_unrealized_percentage": "<string>",
      "currency": "EUR"
    }
  ]
}

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_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

OK

​
account
string
required
​
gross_realized
string
required
​
gross_unrealized
string
required
​
gross_total
string
required
​
net_realized
string
required
​
net_unrealized
string
required
​
net_total
string
required
​
fees
string
required
​
currency
enum<string>
required
Available options:
EUR,
USD,
GBP
​
period_start
string<date-time>
required
​
period_end
string<date-time>
required
​
position_earnings
PositionEarnings · object[]
required