HomeDocumentationAPI Reference
Log In
API Reference

Get Subaccount Value History

Method Name

private/get_subaccount_value_history

Get the value history of a subaccount.
Supported periods: 900 (15m), 3600 (1h), 86400 (1d), 604800 (1w).
Returns up to 1000 entries per request. If the time range exceeds 1000 * period seconds,
the start is clamped forward to return the most recent 1000 entries.
Required minimum session key permission level is read_only

Parameters

end_timestampintegerrequired
End timestamp in unix seconds
periodintegerrequired
Period in seconds. One of 900, 3600, 86400, 604800
start_timestampintegerrequired
Start timestamp in unix seconds
subaccount_idintegerrequired
Subaccount_id

Response

idstring or integerrequired
resultobjectrequired
result.subaccount_idintegerrequired
Subaccount_id
result.subaccount_value_historyarray of objectsrequired
Subaccount value history
result.subaccount_value_history[].currencystringrequired
Currency of the manager (empty string for SRM)
result.subaccount_value_history[].delayed_maintenance_marginstringrequired
Delayed liquidation maintenance margin (0 if not applicable)
result.subaccount_value_history[].initial_marginstringrequired
Initial margin requirement
result.subaccount_value_history[].maintenance_marginstringrequired
Maintenance margin requirement
result.subaccount_value_history[].margin_typestringrequired
Margin type of the subaccount (e.g. PM, PM2, SM)
result.subaccount_value_history[].subaccount_valuestringrequired
Total mark-to-market value of all positions and collaterals
result.subaccount_value_history[].timestampintegerrequired
Timestamp of when the subaccount value was recorded into the database

Example

{request_example_shell}
{request_example_javascript}
{request_example_python}

The above command returns JSON structured like this:

{response_example_json}