Upscale
Menu
On this page

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

Попробовать ↓
GET/accounts/{accountId}/equity-history
Получить историю эквити счета трейдераАккаунты

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

  • Окно задается с помощью timestamp и duration; если ни один из них не указан, оно охватывает последние 5 дней и заканчивается текущим балансом, добавленным в качестве последней точки.
  • На сбойном аккаунте окно привязано к моменту сбоя аккаунта, поэтому серия никогда не выходит за него.
Базовый URL https://api.upscale.trade

Авторизация

bearerhttp · bearerобязательно

Персональный API-ключ с префиксом usk_.

Параметры

Путь
accountIdstring · uuidобязательно

Идентификатор торгового аккаунта. Должен принадлежать вызывающей стороне.

Пример: 00000000-0000-4000-8000-000000000000
Строка запроса
timestampnumberнеобязательно

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

Пример: 1767225599000
durationnumberнеобязательно

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

Пример: -86400000

Примеры

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

Ответы

200Ответapplication/json

Массив AccountsEquityHistoryResponse

timestampnumberобязательно

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

Пример: 1767225599000
volumestringобязательно

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

Пример: 10000000000000
phaseIndexintegerобязательно

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

minimum
0
maximum
9007199254740991
Пример: 1
phaseStartEquitystringобязательно

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

Пример: 10000000000000
401

Неавторизовано

403

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

404

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

429

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