The Account History Performance resource provide access to various historical metrics which you can use to measure aggregate performance of a client or account.
Performance is only calculated on days where the market is open, and is calculated during end of day.
As each endpoint belonging to this resource provides a broad set of datasets, FieldGroups filters can be utilized to reduce response body size, to provide only the metrics that will be used. See each endpoint's query parameters in the reference documentation for specific information.
|Timeseries containing client/account-wide historical performance metrics, such as account/client accumulated return, balances, value, PnL.||Commonly provides data points for to render graphs & charts representing the requesting entity's performance.|
|Summarized metrics specifying high level metrics on the client/account's trading habits, top traded instruments, trades per date, amount of win/loss trades, and more.||Commonly used to to showcase a summary of the requesting entity's historical trading metrics.|
For performance of specific closed trades and positions, see the Client Services resources available.
Example Scenario and Response
As a Client, I want to view my overall performance over time, so I make a request to the "Get account performance" endpoint, defining a date range of the past 9 days. I only want data related to my daily accumulated return, and the combined value of the accounts my client owns.
So I will make a requesting using my ClientKey, and FieldGroups "TimeWeighted_Accumulated" and "Balance_AccountValue" as query parameters. I therefore also expect all values to be returned as converted from specific account currencies in my Client's default currency.
I also want to access some of the summary key metrics of my most active account in a longer, 100 day period. Specifically, the data provided by the field groups "TradeSummary