# Получить историю эквити счета трейдера

`GET /accounts/{accountId}/equity-history`

Эквити счета, замеряемое раз в минуту, сначала самые старые.

- Окно задается с помощью `timestamp` и `duration`; если ни один из них не указан, оно охватывает последние 5 дней и заканчивается текущим балансом, добавленным в качестве последней точки.
- На сбойном аккаунте окно привязано к моменту сбоя аккаунта, поэтому серия никогда не выходит за него.

<a id="authorization"></a>

## Авторизация

bearer: http · bearer (обязательно). Персональный API-ключ с префиксом `usk_`.

<a id="parameters"></a>

## Параметры

- path: accountId (string · uuid; обязательно). Идентификатор торгового аккаунта. Должен принадлежать вызывающей стороне.

Тип: string · uuid

format: uuid

- query: timestamp (number; необязательно). Якорь окна, временная метка Unix в миллисекундах. Если не указан: окно заканчивается в текущий момент (или в момент сбоя аккаунта), и актуальный баланс добавляется как последняя точка.

Тип: number

Пример: 1767225599000

- query: duration (number; необязательно). Длина окна в миллисекундах, по умолчанию 5 дней. Положительное значение: окно начинается в `timestamp` и простирается вперёд. Отрицательное значение: окно заканчивается в `timestamp` (или сейчас) и простирается назад. Ноль отклоняется.

Тип: number

Пример: -86400000

<a id="example-curl"></a>

## Пример · cURL

```bash
curl --request GET 'https://api.upscale.trade/accounts/{accountId}/equity-history' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

<a id="example-javascript"></a>

## Пример · JavaScript

```javascript
const response = await fetch("https://api.upscale.trade/accounts/{accountId}/equity-history", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
});
console.log(response.status, await response.text());
```

<a id="example-python"></a>

## Пример · Python

```python
import requests

response = requests.request(
    "GET",
    "https://api.upscale.trade/accounts/{accountId}/equity-history",
    headers={"Accept":"application/json","Authorization":"Bearer YOUR_API_KEY"},
    timeout=30,
)
print(response.status_code, response.text)
```

<a id="response-200-accountsequityhistoryresponse"></a>

## Ответ 200 · AccountsEquityHistoryResponse

**200** application/json — Ответ

Тип: object[]

[]Схема: AccountsEquityHistoryResponse

[]Тип: object

[]Обязательные поля: timestamp, volume, phaseIndex, phaseStartEquity

[]Типы обязательных полей: timestamp (number; обязательно), volume (string; обязательно), phaseIndex (integer; обязательно), phaseStartEquity (string; обязательно)

- []timestamp (number; обязательно)

[]timestamp пример: 1767225599000

[]timestamp.Тип: number

[]timestamp.Минута, к которой относится образец, временная метка Unix в миллисекундах.

- []volume (string; обязательно)

[]volume пример: 10000000000000

[]volume.Тип: string

[]volume.Эквити счёта на эту минуту — баланс плюс нереализованный PnL открытых позиций, fp9 в исходном виде.

- []phaseIndex (integer; обязательно)

[]phaseIndex пример: 1

[]phaseIndex.Тип: integer

[]phaseIndex.Индекс торговой фазы, к которой относится образец.

[]phaseIndex.minimum: 0

[]phaseIndex.maximum: 9007199254740991

- []phaseStartEquity (string; обязательно)

[]phaseStartEquity пример: 10000000000000

[]phaseStartEquity.Тип: string

[]phaseStartEquity.Начальное эквити торговой фазы образца, fp9 в исходном виде.

Пример



```json
[
  {
    "timestamp": 1767225599000,
    "volume": "10000000000000",
    "phaseIndex": 1,
    "phaseStartEquity": "10000000000000"
  }
]
```

<a id="response-401"></a>

## Ответ 401

**401**  — Неавторизовано

<a id="response-403"></a>

## Ответ 403

**403**  — Аккаунт принадлежит другому пользователю (`account_access_denied`), или запрос аутентифицирован с помощью API-ключа, тогда как `api_trading` отключён на аккаунте (`api_trading_not_enabled`).

<a id="response-404"></a>

## Ответ 404

**404**  — Нет аккаунта с этим идентификатором.

<a id="response-429"></a>

## Ответ 429

**429**  — Превышен лимит частоты запросов API-ключа (`api_key_rate_limit_exceeded`). `Retry-After` указывает, когда вернуться; тело содержит бакет (`read` / `write`), окно, которое сработало, его лимит и `retryAt`.