/accounts/{accountId}/risk-statusLa instantánea de riesgo que el motor de trading mantiene para la cuenta: saldo y equity actuales, equity al inicio del día y equity máximo, el contador de días de trading, el estado de la regla de consistencia y la línea base de payout.
- Se lee en vivo desde el shard que aloja la cuenta, por lo que las posiciones abiertas ya están reflejadas en el equity.
- Las sesiones interactivas obtienen un presupuesto para este endpoint aparte de los otros; en cambio, una clave de API está limitada por sus propios límites de lectura.
https://api.upscale.tradeParámetros
accountIdstring · uuidobligatorioIdentificador de la cuenta del trader. Debe pertenecer al solicitante.
00000000-0000-4000-8000-000000000000Ejemplos
curl --request GET 'https://api.upscale.trade/accounts/{accountId}/risk-status' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'const response = await fetch("https://api.upscale.trade/accounts/{accountId}/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/{accountId}/risk-status",
headers={"Accept":"application/json","Authorization":"Bearer YOUR_API_KEY"},
timeout=30,
)
print(response.status_code, response.text)Respuestas
200Respuestaapplication/json
accountIdstring · uuidobligatorioTrader account the snapshot belongs to.
- 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-000000000000tradingDaysnumberobligatorioNumber of days the account has traded on — counted against the minimum trading days of the challenge.
0currentBalancestring · int32obligatorioAccount balance without the unrealised pnl of open positions, fp9 raw.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000currentEquitystring · int32obligatorioBalance plus the unrealised pnl of open positions, fp9 raw. This is what drawdown rules are measured against.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000dayStartEquitystring · int32obligatorioEquity the current trading day opened at, fp9 raw — the base of the daily drawdown limit.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxEquitystring · int32 · nullableobligatorioHighest equity the account has ever reached, fp9 raw — the base of the trailing drawdown. Null before the first trade.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000periodStartEquitystring · int32 · nullableobligatorioEquity the current withdrawal period opened at, fp9 raw. Null while no period is running.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxPeriodDailyEquityDeltastring · int32 · nullableobligatorioLargest single-day equity gain inside the current period, fp9 raw — the numerator of the consistency rule. Null while no day has closed in profit.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxPeriodDailyEquityDeltaAtstring · date-time · nullableobligatorioDay that produced maxPeriodDailyEquityDelta. Null together with it.
2026-05-01T12:30:00.000ZconsistencyRuleAppliesbooleanobligatorioWhether the consistency rule is part of the rules of this account in its current phase.
trueconsistencyRuleMetboolean[]obligatorioWhether the rule is currently satisfied. Null while the period is not in profit and the ratio cannot be computed.
Elementos del array · boolean
boolean
Ver ejemplo
[
true
]consistencyRuleRatiostring · int32 · nullableobligatorioShare of the period profit made on its best day, fp9 raw fraction. Null together with consistencyRuleMet.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000consistencyRuleLimitstring · int32obligatorioLargest share of period profit one day may account for, fp9 raw fraction (300000000 = 30%). A ratio above it fails the rule.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000payoutBaselineBalancestring · int32obligatorioBalance the next payout is measured from, fp9 raw. Equal to the initial account size until the first payout moves it.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000isPayoutBaselineRequirementMetbooleanobligatorioWhether equity is above payoutBaselineBalance — the condition for being eligible to request a payout.
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
}No autorizado
La cuenta pertenece a otro usuario (account_access_denied), o la solicitud se autentica con una clave de API mientras api_trading está deshabilitado en la cuenta (api_trading_not_enabled).
No hay ninguna cuenta con este identificador.
Se superó el límite de velocidad de la clave de API (api_key_rate_limit_exceeded). Retry-After indica cuándo volver; el cuerpo incluye el bucket (read / write), la ventana que se activó, su límite y retryAt.