Получить статус риска всех аккаунтов текущего пользователя

GET/accounts/risk-status

Получить статус риска всех аккаунтов текущего пользователяАккаунты

Снимок риска по каждому аккаунту, сразу для всех аккаунтов вызывающего.

При аутентификации с помощью API-ключа включаются только аккаунты, у которых включён api_trading.
Интерактивные сессии здесь совместно используют один бюджет со статусом риска отдельного счёта; а API-ключ вместо этого ограничен своими собственными лимитами на чтение.

Базовый URL https://api.upscale.trade

Авторизация

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

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

Примеры

curl --request GET 'https://api.upscale.trade/accounts/risk-status' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

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

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

Ответы

401

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

429

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

defaultОтветapplication/json

Массив AccountsRiskStatusResponse

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

Счёт трейдера, к которому относится снимок.

pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Пример: 00000000-0000-4000-8000-000000000000

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

Количество дней, в течение которых счёт торговал, — учитывается для минимального количества торговых дней челленджа.

Пример: 0

currentBalancestring · int32обязательно

Баланс счёта без нереализованного PnL открытых позиций, fp9 в исходном виде.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

currentEquitystring · int32обязательно

Баланс плюс нереализованный PnL открытых позиций, fp9 в исходном виде. Именно относительно этого измеряются правила просадки.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

dayStartEquitystring · int32обязательно

Эквити на момент открытия текущего торгового дня, fp9 в исходном виде — база дневного лимита просадки.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

maxEquitystring · int32 · nullableобязательно

Наивысшее эквити, которого когда-либо достигал счёт, fp9 в исходном виде — база следящей просадки. Null до первой сделки.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

periodStartEquitystring · int32 · nullableобязательно

Эквити на момент открытия текущего периода вывода, fp9 в исходном виде. Null, пока не идёт ни один период.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

maxPeriodDailyEquityDeltastring · int32 · nullableобязательно

Наибольший однодневный прирост эквити внутри текущего периода, fp9 в сыром виде — числитель правила согласованности. Null, пока ни один день не закрылся с прибылью.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

maxPeriodDailyEquityDeltaAtstring · date-time · nullableобязательно

День, в котором был получен maxPeriodDailyEquityDelta. Null вместе с ним.

Пример: 2026-05-01T12:30:00.000Z

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

Является ли правило согласованности частью правил этого счёта в его текущей фазе.

Пример: true

consistencyRuleMetboolean[]обязательно

Выполняется ли правило в настоящее время. Null, пока период не в прибыли и коэффициент не может быть вычислен.

Элементы массива · boolean

boolean

Посмотреть пример

[
  true
]

consistencyRuleRatiostring · int32 · nullableобязательно

Доля прибыли за период, полученная в его лучший день, fp9 в виде необработанной дроби. Null вместе с consistencyRuleMet.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

consistencyRuleLimitstring · int32обязательно

Наибольшая доля прибыли за период, которую может составлять один день, fp9 в виде необработанной дроби (300000000 = 30%). Если коэффициент превышает её, правило не выполняется.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

payoutBaselineBalancestring · int32обязательно

Баланс, от которого отсчитывается следующая выплата, fp9 в необработанном виде. Равен начальному размеру счёта, пока первая выплата не сдвинет его.

pattern: ^(?:-?[1-9][0-9]*|0)$

Пример: 1000000000

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

Превышает ли собственный капитал payoutBaselineBalance — условие для права запросить выплату.

Пример: true

[
  {
    "accountId": "00000000-0000-4000-8000-000000000000",
    "tradingDays": 0,
    "currentBalance": "1000000000",
    "currentEquity": "1000000000",
    "dayStartEquity": "1000000000",
    "maxEquity": "1000000000",
    "periodStartEquity": "1000000000",
    "maxPeriodDailyEquityDelta": "1000000000",
    "maxPeriodDailyEquityDeltaAt": "2026-05-01T12:30:00.000Z",
    "consistencyRuleApplies": true,
    "consistencyRuleMet": [
      true
    ],
    "consistencyRuleRatio": "1000000000",
    "consistencyRuleLimit": "1000000000",
    "payoutBaselineBalance": "1000000000",
    "isPayoutBaselineRequirementMet": true
  }
]