API reference ยท Risk and history
/v1/accounts/{account_id}/progressGet progress.
Read
Each objective (profit target, trading days) and each loss limit, with where it stands.
Path parameters#
-
The account number.
Responses#
200OK
-
Where the account is in the programme.
One of
evaluationfundedsandbox -
Show 3 fields
-
Show 5 fields
-
The balance that reaches it.
-
Still to make.
-
How far, in percent.
-
Positions must be closed when it is reached.
-
Whether it is reached.
One of
openmet
-
-
-
Show 2 fields
-
Show 11 fields
-
limitdecimal stringThe limit, in USD.
-
floordecimal stringThe equity at which it is breached.
-
roomdecimal stringHow much more the account may lose before it.
-
used_pctdecimal string or nullHow much of it is used, in percent.
-
resets_atinteger, Unix msDaily loss only: when it resets (midnight New York).
-
on_breachstringDaily loss only: what happens when it is reached.
One of
fail_accountflattenflatten_and_pause -
estimatedbooleanDaily loss only: the day's start is estimated (the engine does not publish it).
-
modestringMax drawdown only: how the reference moves.
One of
end_of_dayend_of_tradestaticintraday_equity -
at_leastbooleanMax drawdown only: the engine may hold a higher floor than shown (it follows equity highs).
-
The rule no longer applies this limit (its cut-off was reached).
-
Where it stands.
One of
okwarningcriticalbreached
-
-
Show 11 fields
-
limitdecimal stringThe limit, in USD.
-
floordecimal stringThe equity at which it is breached.
-
roomdecimal stringHow much more the account may lose before it.
-
used_pctdecimal string or nullHow much of it is used, in percent.
-
resets_atinteger, Unix msDaily loss only: when it resets (midnight New York).
-
on_breachstringDaily loss only: what happens when it is reached.
One of
fail_accountflattenflatten_and_pause -
estimatedbooleanDaily loss only: the day's start is estimated (the engine does not publish it).
-
modestringMax drawdown only: how the reference moves.
One of
end_of_dayend_of_tradestaticintraday_equity -
at_leastbooleanMax drawdown only: the engine may hold a higher floor than shown (it follows equity highs).
-
The rule no longer applies this limit (its cut-off was reached).
-
Where it stands.
One of
okwarningcriticalbreached
-
-
-
Show 4 fields
-
A payout may be requested now.
-
What may be paid out.
-
The smallest payout.
-
Paid out so far.
-
-
When the oldest figure here was read.
401The request has no Authorization header.
{
"error": {
"type": "authentication",
"code": "missing_api_key",
"message": "No API key: send it as Authorization: Bearer <key>.",
"request_id": "req_0f9c2a7d8e1b4c6a9f3e5d7b1a2c4e6f",
"retryable": false,
"doc_url": "https://docs.phoenixperpsfunding.com/reference/errors#missing_api_key"
}
}403The key only works from the addresses you listed.
{
"error": {
"type": "permission",
"code": "ip_not_allowed",
"message": "This address is not on the key's allowlist.",
"request_id": "req_0f9c2a7d8e1b4c6a9f3e5d7b1a2c4e6f",
"retryable": false,
"doc_url": "https://docs.phoenixperpsfunding.com/reference/errors#ip_not_allowed"
}
}404The account does not exist in this environment, or the key does not reach it.
{
"error": {
"type": "not_found",
"code": "account_not_found",
"message": "No account with that id is reachable with this key.",
"request_id": "req_0f9c2a7d8e1b4c6a9f3e5d7b1a2c4e6f",
"retryable": false,
"doc_url": "https://docs.phoenixperpsfunding.com/reference/errors#account_not_found"
}
}409The account exists but is not open on the trading engine yet.
{
"error": {
"type": "conflict",
"code": "account_not_ready",
"message": "This account is still being opened.",
"request_id": "req_0f9c2a7d8e1b4c6a9f3e5d7b1a2c4e6f",
"retryable": true,
"doc_url": "https://docs.phoenixperpsfunding.com/reference/errors#account_not_ready"
}
}429A request budget is used up (details.scope says which).
{
"error": {
"type": "rate_limit",
"code": "rate_limited",
"message": "Too many requests: slow down.",
"request_id": "req_0f9c2a7d8e1b4c6a9f3e5d7b1a2c4e6f",
"retryable": true,
"doc_url": "https://docs.phoenixperpsfunding.com/reference/errors#rate_limited"
}
}500An error we did not expect.
{
"error": {
"type": "server",
"code": "internal_error",
"message": "Something went wrong on our side.",
"request_id": "req_0f9c2a7d8e1b4c6a9f3e5d7b1a2c4e6f",
"retryable": true,
"doc_url": "https://docs.phoenixperpsfunding.com/reference/errors#internal_error"
}
}503The trading engine did not give a complete answer in time; nothing partial is returned.
{
"error": {
"type": "engine",
"code": "state_unavailable",
"message": "The account's figures cannot be read right now.",
"request_id": "req_0f9c2a7d8e1b4c6a9f3e5d7b1a2c4e6f",
"retryable": true,
"doc_url": "https://docs.phoenixperpsfunding.com/reference/errors#state_unavailable"
}
}Errors#
Codes this endpoint can return. Match on the code, never on the message.