/accounts/with-risk-statusTodas las cuentas del solicitante como un registro completo —desafío, fase, estado, saldos y opciones habilitadas— con su instantánea de riesgo adjunta.
- Autenticado con una clave de API, solo se incluyen las cuentas que tienen
api_tradinghabilitado. - Las sesiones interactivas comparten un presupuesto aquí con los endpoints de estado de riesgo; en cambio, una clave de API está limitada por sus propios límites de lectura.
https://api.upscale.tradeEjemplos
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)Respuestas
No autorizado
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.
defaultRespuestaapplication/json
Array de AccountWithRiskStatusResponse
accountIdstring · uuidobligatorioIdentificador de la cuenta del trader.
- 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-000000000000userIdstring · uuidobligatorioPropietario de la cuenta.
- 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-000000000000paymentIdstring · uuid · nullableobligatorioPago con el que se compró el desafío detrás de esta cuenta. Null para las cuentas que no fueron compradas.
- 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-000000000000challengeIdstring · nullableobligatorioDesafío que ejecuta la cuenta. Null para cuentas demo y de torneo.
challenge1tournamentIdstring · uuid · nullableobligatorioTorneo para el que se creó la cuenta. Nulo fuera de las cuentas de torneo.
- 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-000000000000typestring · enumobligatorioTipo de cuenta: un desafío de pago (real), una cuenta demo, o una entrada tournament.
"demo" "real" "tournament"demoinitialPhasestringobligatorioFase en la que comenzó la cuenta.
active_evaluationcurrentPhasestringobligatorioFase en la que está la cuenta ahora: active_evaluation, active_verification, funded, o funded_success una vez que tenga suficientes días rentables.
active_evaluationstatusstring · enumobligatorioEstado de la cuenta. Se puede operar en active; los estados trading_locked_* solo permiten cerrar, y el resto detiene el trading por completo.
"pending" "active" "archived" "archive_expired" "failed" "frozen" "suspended" "closed" "trading_locked_by_funded_limit" "trading_locked_by_instant_funded_limit" "phase_transition_pending" "transition_review"activeprofitTargetstring · nullableobligatorioBeneficio que el saldo liquidado necesita para superar la fase actual, en porcentaje del saldo inicial — no fp9. Nulo cuando la fase no tiene objetivo.
5maxDailyDrawdownstring · nullableobligatorioLímite de drawdown diario de la fase actual, en porcentaje del saldo inicial — no fp9. La pérdida se cuenta desde dayStartEquity. Nulo cuando la fase no tiene límite diario.
5maxTotalDrawdownstring · nullableobligatorioLímite de drawdown total de la fase actual, en porcentaje del saldo inicial — no fp9. Nulo cuando la fase no tiene límite total.
10maxTrailingTotalDrawdownstring · nullableobligatorioLímite de drawdown móvil de la fase actual, en porcentaje del mayor capital alcanzado — no fp9. Nulo cuando la fase no tiene límite móvil.
6drawdownBasestring · fp9 · nullableobligatorioEquity desde el que se mide el drawdown de la fase financiada, fp9 en bruto. Nulo mientras se mide desde el saldo inicial.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxDrawdownStopstring · fp9 · nullableobligatorioNivel de equity en el que el drawdown de la fase financiada hace fallar la cuenta, fp9 en bruto. Nulo mientras se deriva del saldo inicial.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000minTradingDaysnumber · nullableobligatorioDías rentables (profitableDays) requeridos antes de que se pueda superar la fase actual. Nulo cuando la fase no tiene mínimo.
3suspendedUntilstring · date-time · nullableobligatorioCuándo se levanta una suspensión de la cuenta. Nulo cuando no está suspendida.
2023-10-01T00:00:00.000ZaccountBalancestring · fp9obligatorioSaldo sin el pnl no realizado de las posiciones abiertas, fp9 en bruto.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000initialAccountBalancestring · fp9obligatorioSaldo con el que se abrió la cuenta, fp9 en bruto — el tamaño nominal del desafío.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxEquitystring · fp9 · nullableobligatorioEl equity más alto que ha alcanzado la cuenta, fp9 en bruto. Nulo antes de la primera operación.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000dayStartEquitystring · fp9 · nullableobligatorioEquity con el que abrió el día de trading actual, fp9 en bruto.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000profitableDaysnumberobligatorioDías rentables contados en el período de retiro actual.
0prevPeriodProfitableDaysnumberobligatorioDías rentables contados en el período de retiro anterior.
0archivedAtstring · date-time · nullableobligatorioInicio del período de archivo de la cuenta.
2026-05-01T12:30:00.000ZarchiveRestoreAvailableUntilstring · date-time · nullableobligatorioFecha límite de desarchivado, independiente de la Restauración paga.
2026-05-01T12:30:00.000ZcreatedAtstring · date-timeobligatorioCuándo se creó la cuenta.
2026-05-01T12:30:00.000ZfailureReasonstring · enum · nullableobligatorioRegla que hizo fallar la cuenta. Nulo mientras no haya fallado.
"archive_expired" "max_total_drawdown" "max_trailing_total_drawdown" "max_daily_drawdown"archive_expiredfundedAtstring · date-time · nullableobligatorioMomento en que la cuenta alcanzó la fase financiada. Nulo antes de eso.
2026-05-01T12:30:00.000ZfailedAtstring · date-time · nullableobligatorioMomento en que la cuenta falló. Nulo mientras no lo haya hecho.
2026-05-01T12:30:00.000ZtransitionReviewAtstring · date-time · nullableobligatorioMomento en que se envió la transición de fase para revisión manual. Nulo cuando no hay ninguna revisión pendiente.
2026-05-01T12:30:00.000ZcurrentWithdrawalPeriodStartedAtstring · date-time · nullableobligatorioInicio del período de retiro en curso. Nulo mientras no haya ninguno en curso.
2026-05-01T12:30:00.000ZfundedLimitUnlockedAtstring · date-time · nullableobligatorioCuándo salió la cuenta por última vez de un bloqueo de capital gestionado; los días de negociación del período se cuentan a partir de aquí. Nulo cuando nunca estuvo bloqueada.
2026-05-01T12:30:00.000ZmaxWithdrawalAmountstring · fp9obligatorioImporte máximo que puede retirarse de la cuenta en este momento, fp9 en bruto.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000payoutBaselineBalancestring · fp9obligatorioSaldo a partir del cual se mide el próximo pago, fp9 en bruto. Igual al saldo inicial hasta que el primer pago lo modifica.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000isActiveWithdrawalInPeriodbooleanobligatorioIndica si una solicitud de retirada ya está en curso para el período actual.
trueprofitSplitPercentnumberobligatorioParticipación del beneficio pagado al trader, en porcentaje.
80debtstring · fp9obligatorioDeuda pendiente de descuento promocional de la cuenta, fp9 en bruto. Se retiene del siguiente pago; 0 cuando no hay ninguno.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000dailyDrawdownProtectionobject · nullableobligatorioProtección diaria contra drawdown de la cuenta. Nula cuando la cuenta no tiene la opción.
Objeto · 1 campo
usedAtstring · date-time · nullableobligatorioCuándo se consumió la protección. Nula mientras siga disponible.
2026-05-01T12:30:00.000ZVer ejemplo
{
"usedAt": "2026-05-01T12:30:00.000Z"
}aiFailedReportbooleanobligatorioSi se ha generado un informe automatizado para el fallo de esta cuenta.
trueapiTradingbooleanobligatorioSi la cuenta puede operarse con una clave API personal. Las solicitudes realizadas con una clave se rechazan en las cuentas donde esto es falso.
trueavailableMarketsstring · enumobligatorioCategoría de mercado en la que la cuenta puede operar: crypto, rwa o all.
"crypto" "rwa" "all"cryptoantifraudStatusstring · enumobligatorioEstado antifraude de la cuenta; cualquier valor distinto de normal la marca para revisión.
"normal" "test_account" "balance_exceeded" "manually_flagged" "manually_cleared"normaltradingLockReasonstring · nullableobligatorioMotivo por el que el trading está bloqueado: auto para el límite de capital gestionado alcanzado en la promoción; de lo contrario, el motivo que indicó un administrador. Nulo cuando la cuenta no está bloqueada.
stringtournamentobject · nullableobligatorioTorneo al que pertenece la cuenta. Nulo para cuentas fuera de un torneo.
Objeto · 5 campos
idstring · uuidobligatorioIdentificador del torneo.
- 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-000000000000statusstring · enumobligatorioEtapa en la que se encuentra el torneo.
"active" "completed"activestartDatestring · date-timeobligatorioCuándo se abre el torneo para operar.
2026-05-01T12:30:00.000ZendDatestring · date-timeobligatorioCuándo cierra el torneo.
2026-05-01T12:30:00.000ZfinalRecalcDonebooleanobligatorioSi la clasificación final se ha recalculado después del cierre.
trueVer ejemplo
{
"id": "00000000-0000-4000-8000-000000000000",
"status": "active",
"startDate": "2026-05-01T12:30:00.000Z",
"endDate": "2026-05-01T12:30:00.000Z",
"finalRecalcDone": true
}restoreobjectobligatorioSi una cuenta financiada fallida puede recuperarse y hasta cuándo.
Objeto · 2 campos
restoreAvailablebooleanobligatorioSi la cuenta fondeada fallida puede restaurarse ahora mismo.
truerestoreAvailableUntilstring · date-time · nullableobligatorioCuándo se cierra la ventana de restauración. Nulo cuando no hay ventana.
2026-05-01T12:30:00.000ZVer ejemplo
{
"restoreAvailable": true,
"restoreAvailableUntil": "2026-05-01T12:30:00.000Z"
}riskStatusobjectobligatorioInstantánea de riesgo en vivo de esta cuenta, la misma carga útil que devuelven los endpoints de estado de riesgo.
Objeto · 15 campos
accountIdstring · uuidobligatorioCuenta de trader a la que pertenece la instantánea.
- 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-000000000000tradingDaysnumberobligatorioDías rentables del período de retiro actual — el mismo contador que profitableDays de la cuenta, no los días con operaciones. Un día cuenta cuando el capital crece al menos 0.5% del saldo inicial; minTradingDays se compara con este número.
0currentBalancestring · fp9obligatorioSaldo de la cuenta sin el pnl no realizado de las posiciones abiertas, fp9 en bruto.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000currentEquitystring · fp9obligatorioSaldo más el pnl no realizado de las posiciones abiertas, fp9 en bruto. Esto es contra lo que se miden las reglas de drawdown.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000dayStartEquitystring · fp9obligatorioEquity con el que abrió el día de trading actual, fp9 en bruto — la base del límite de drawdown diario.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxEquitystring · fp9 · nullableobligatorioEquity más alto que la cuenta ha alcanzado jamás, fp9 en bruto — la base del drawdown móvil. Nulo antes de la primera operación.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000periodStartEquitystring · fp9 · nullableobligatorioEquity con el que se abrió el período de retiro actual, fp9 en bruto. Nulo mientras no haya ningún período en curso.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxPeriodDailyEquityDeltastring · fp9 · nullableobligatorioMayor ganancia de equity en un solo día dentro del período actual, fp9 en bruto — el numerador de la regla de consistencia. Nulo mientras ningún día haya cerrado en beneficio.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000maxPeriodDailyEquityDeltaAtstring · date-time · nullableobligatorioDía que produjo maxPeriodDailyEquityDelta. Nulo junto con él.
2026-05-01T12:30:00.000ZconsistencyRuleAppliesbooleanobligatorioSi la regla de consistencia es parte de las reglas de esta cuenta en su fase actual.
trueconsistencyRuleMetboolean · nullableobligatorioSi la regla se cumple actualmente. Nulo mientras el período no esté en beneficio y el ratio no pueda calcularse.
trueconsistencyRuleRatiostring · fp9 · nullableobligatorioProporción del beneficio del período obtenido en su mejor día, fp9 fracción en bruto. Nulo junto con consistencyRuleMet.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000consistencyRuleLimitstring · fp9obligatorioMayor proporción del beneficio del período que puede representar un día, fp9 fracción sin procesar (300000000 = 30%). Una ratio superior a ella no cumple la regla.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000payoutBaselineBalancestring · fp9obligatorioSaldo desde el que se mide el próximo pago, fp9 en bruto. Igual al tamaño inicial de la cuenta hasta que el primer pago lo modifica.
- pattern
- ^(?:-?[1-9][0-9]*|0)$
1000000000isPayoutBaselineRequirementMetbooleanobligatorioSi el capital está por encima de payoutBaselineBalance — la condición para ser elegible para solicitar un pago.
trueVer ejemplo
{
"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
}[
{
"accountId": "00000000-0000-4000-8000-000000000000",
"userId": "00000000-0000-4000-8000-000000000000",
"paymentId": "00000000-0000-4000-8000-000000000000",
"challengeId": "challenge1",
"tournamentId": "00000000-0000-4000-8000-000000000000",
"type": "demo",
"initialPhase": "active_evaluation",
"currentPhase": "active_evaluation",
"status": "active",
"profitTarget": "5",
"maxDailyDrawdown": "5",
"maxTotalDrawdown": "10",
"maxTrailingTotalDrawdown": "6",
"drawdownBase": "1000000000",
"maxDrawdownStop": "1000000000",
"minTradingDays": 3,
"suspendedUntil": "2023-10-01T00:00:00.000Z",
"accountBalance": "1000000000",
"initialAccountBalance": "1000000000",
"maxEquity": "1000000000",
"dayStartEquity": "1000000000",
"profitableDays": 0,
"prevPeriodProfitableDays": 0,
"archivedAt": "2026-05-01T12:30:00.000Z",
"archiveRestoreAvailableUntil": "2026-05-01T12:30:00.000Z",
"createdAt": "2026-05-01T12:30:00.000Z",
"failureReason": "archive_expired",
"fundedAt": "2026-05-01T12:30:00.000Z",
"failedAt": "2026-05-01T12:30:00.000Z",
"transitionReviewAt": "2026-05-01T12:30:00.000Z",
"currentWithdrawalPeriodStartedAt": "2026-05-01T12:30:00.000Z",
"fundedLimitUnlockedAt": "2026-05-01T12:30:00.000Z",
"maxWithdrawalAmount": "1000000000",
"payoutBaselineBalance": "1000000000",
"isActiveWithdrawalInPeriod": true,
"profitSplitPercent": 80,
"debt": "1000000000",
"dailyDrawdownProtection": {
"usedAt": "2026-05-01T12:30:00.000Z"
},
"aiFailedReport": true,
"apiTrading": true,
"availableMarkets": "crypto",
"antifraudStatus": "normal",
"tradingLockReason": "string",
"tournament": {
"id": "00000000-0000-4000-8000-000000000000",
"status": "active",
"startDate": "2026-05-01T12:30:00.000Z",
"endDate": "2026-05-01T12:30:00.000Z",
"finalRecalcDone": true
},
"restore": {
"restoreAvailable": true,
"restoreAvailableUntil": "2026-05-01T12:30:00.000Z"
},
"riskStatus": {
"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
}
}
]