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

GET/accounts/with-risk-status

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

Каждый счёт вызывающего в виде полной записи — челлендж, фаза, статус, балансы и включённые опции — с прикреплённым к нему снимком риска.

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

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

Авторизация

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

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

Примеры

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

const response = await fetch("https://api.upscale.trade/accounts/with-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/with-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

Body[0].challengeId must be array Body[0].profitTarget must be array Body[0].maxDailyDrawdown must be array

Массив AccountWithRiskStatusResponse

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

userIdstring · 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

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

Платёж, с помощью которого был приобретён челлендж, связанный с этим счётом. Null для счетов, которые не были приобретены.

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

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

Челлендж, который проходит счёт. Null для демо-счетов и турнирных счетов.

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

string

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

Турнир, для которого был создан аккаунт. Null вне турнирных аккаунтов.

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

typestring · enumобязательно

Тип аккаунта: платный челлендж (real), аккаунт demo или участие tournament.

Допустимо: "demo" "real" "tournament"

Пример: demo

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

Фаза, в которой аккаунт начал работу.

Пример: active_evaluation

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

Фаза, в которой аккаунт находится сейчас: active_evaluation, active_verification, funded или funded_success, как только у него будет достаточно прибыльных дней.

Пример: active_evaluation

statusstring · enumобязательно

Статус аккаунта. Торговля возможна при active; статусы trading_locked_* позволяют только закрывать, а остальные полностью останавливают торговлю.

Допустимо: "pending" "active" "failed" "frozen" "suspended" "closed" "trading_locked_by_funded_limit" "trading_locked_by_instant_funded_limit" "phase_transition_pending" "transition_review"

Пример: active

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

Прибыль, необходимая для прохождения текущей фазы, в процентах от начального баланса. Null, когда у фазы нет цели.

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

string

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

Дневной лимит просадки текущей фазы, в процентах от эквити на начало дня. Null, когда у фазы нет дневного лимита.

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

string

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

Общий лимит просадки текущей фазы, в процентах от начального баланса. Null, когда у фазы нет общего лимита.

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

string

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

Лимит трейлинг-просадки текущей фазы, в процентах от максимального достигнутого эквити. Null, когда у фазы нет лимита трейлинг-просадки.

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

string

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

Эквити, от которого измеряется просадка финансируемой фазы, fp9 в исходном виде. Null, пока просадка измеряется от начального баланса.

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

Пример: 1000000000

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

Уровень equity, при котором просадка на этапе финансирования приводит к провалу счета, fp9 raw. Null, пока он выводится из начального баланса.

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

Пример: 1000000000

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

Торговые дни, необходимые до того, как текущий этап может быть пройден. Null, когда у этапа нет минимума.

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

number

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

Когда приостановка счета снимается. Null, когда он не приостановлен.

Пример: 2023-10-01T00:00:00.000Z

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

Баланс без нереализованного pnl открытых позиций, fp9 raw.

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

Пример: 1000000000

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

Баланс, с которым был открыт счет, fp9 raw — номинальный размер челленджа.

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

Пример: 1000000000

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

Наибольшее значение средств, которого достиг счёт, fp9 в сыром виде. Null до первой сделки.

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

Пример: 1000000000

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

Средства на открытии текущего торгового дня, fp9 в сыром виде.

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

Пример: 1000000000

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

Прибыльные дни, засчитанные в текущем периоде вывода.

Пример: 0

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

Прибыльные дни, засчитанные в предыдущем периоде вывода.

Пример: 0

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

Когда счёт был создан.

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

failureReasonstring · enum · nullableобязательно

Правило, которое привело к провалу аккаунта. Null, пока аккаунт не провален.

Допустимо: "max_total_drawdown" "max_trailing_total_drawdown" "max_daily_drawdown" null

Пример: max_total_drawdown

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

Когда аккаунт достиг этапа финансирования. Null до этого.

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

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

Когда аккаунт провалился. Null, пока он не провален.

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

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

Когда переход фазы был отправлен на ручную проверку. Null, когда никакая проверка не ожидается.

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

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

Начало текущего периода вывода. Null, пока такой период не запущен.

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

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

Когда счёт в последний раз вышел из блокировки управляемого капитала; торговые дни периода отсчитываются отсюда. Null, если он никогда не был заблокирован.

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

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

Наибольшая сумма, которая может быть выведена со счёта прямо сейчас, fp9 в исходном виде.

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

Пример: 1000000000

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

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

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

Пример: 1000000000

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

Находится ли запрос на вывод уже в обработке за текущий период.

Пример: true

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

Доля прибыли, выплачиваемая трейдеру, в процентах.

Пример: 80

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

Непогашенный долг по промо-скидке счёта, fp9 в исходном виде. Удерживается из следующей выплаты; 0, когда её нет.

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

Пример: 1000000000

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

Ежедневная защита от просадки счёта. Null, когда у счёта нет этой опции.

Объект · 1 поле

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

Когда защита была израсходована. Null, пока она всё ещё доступна.

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

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

{
  "usedAt": "2026-05-01T12:30:00.000Z"
}

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

Был ли сформирован автоматический отчёт о сбое этого счёта.

Пример: true

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

Можно ли торговать на счёте с личным API-ключом. Запросы, сделанные с ключом, отклоняются на счетах, где это false.

Пример: true

availableMarketsstring · enumобязательно

Категория рынка, в которой аккаунт может торговать: crypto, rwa или all.

Допустимо: "crypto" "rwa" "all"

Пример: crypto

antifraudStatusstring · enumобязательно

Состояние антифрода аккаунта; всё, кроме normal, помечает его для проверки.

Допустимо: "normal" "test_account" "balance_exceeded" "manually_flagged" "manually_cleared"

Пример: normal

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

Почему торговля заблокирована: auto при достижении лимита управляемого капитала на промоакции, иначе причина, указанная администратором. Null, когда аккаунт не заблокирован.

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

string

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

[
  "string"
]

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

Турнир, к которому относится аккаунт. Null для аккаунтов вне турнира.

Объект · 5 поля

idstring · 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

statusstring · enumобязательно

Стадия, в которой находится турнир.

Допустимо: "active" "completed"

Пример: active

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

Когда турнир открывается для торговли.

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

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

Когда турнир закрывается.

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

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

Были ли пересчитаны итоговые турнирные таблицы после закрытия.

Пример: true

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

{
  "id": "00000000-0000-4000-8000-000000000000",
  "status": "active",
  "startDate": "2026-05-01T12:30:00.000Z",
  "endDate": "2026-05-01T12:30:00.000Z",
  "finalRecalcDone": true
}

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

Можно ли восстановить проваленный финансируемый счёт и до какого момента.

Объект · 2 поля

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

Можно ли восстановить неудачный финансируемый аккаунт прямо сейчас.

Пример: true

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

Когда закрывается окно восстановления. Null, когда окна нет.

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

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

{
  "restoreAvailable": true,
  "restoreAvailableUntil": "2026-05-01T12:30:00.000Z"
}

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

Актуальный снимок риска этого счёта, та же полезная нагрузка, которую возвращают эндпоинты статуса риска.

Объект · 15 поля

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 · nullableобязательно

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

Пример: 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
}