Obtener todas las cuentas del usuario actual con estado de riesgo

GET/accounts/with-risk-status

Obtener todas las cuentas del usuario actual con estado de riesgoCuentas

Todas 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_trading habilitado.
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.

URL base https://api.upscale.trade

Autorización

bearerhttp · bearerobligatorio

Clave de API personal, con el prefijo usk_.

Ejemplos

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

401

No autorizado

429

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

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

Array de AccountWithRiskStatusResponse

accountIdstring · uuidobligatorio

Identificador 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})$

Ejemplo: 00000000-0000-4000-8000-000000000000

userIdstring · uuidobligatorio

Propietario 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})$

Ejemplo: 00000000-0000-4000-8000-000000000000

paymentIdstring · uuid · nullableobligatorio

Pago 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})$

Ejemplo: 00000000-0000-4000-8000-000000000000

challengeIdstring[]obligatorio

Desafío que ejecuta la cuenta. Null para cuentas demo y de torneo.

Elementos del array · string

string

tournamentIdstring · uuid · nullableobligatorio

Torneo 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})$

Ejemplo: 00000000-0000-4000-8000-000000000000

typestring · enumobligatorio

Tipo de cuenta: un desafío de pago (real), una cuenta demo, o una entrada tournament.

Permitido: "demo" "real" "tournament"

Ejemplo: demo

initialPhasestringobligatorio

Fase en la que comenzó la cuenta.

Ejemplo: active_evaluation

currentPhasestringobligatorio

Fase en la que está la cuenta ahora: active_evaluation, active_verification, funded, o funded_success una vez que tenga suficientes días rentables.

Ejemplo: active_evaluation

statusstring · enumobligatorio

Estado de la cuenta. Se puede operar en active; los estados trading_locked_* solo permiten cerrar, y el resto detiene el trading por completo.

Permitido: "pending" "active" "failed" "frozen" "suspended" "closed" "trading_locked_by_funded_limit" "trading_locked_by_instant_funded_limit" "phase_transition_pending" "transition_review"

Ejemplo: active

profitTargetstring[]obligatorio

Beneficio necesario para superar la fase actual, en porcentaje del saldo inicial. Nulo cuando la fase no tiene objetivo.

Elementos del array · string

string

maxDailyDrawdownstring[]obligatorio

Límite de drawdown diario de la fase actual, en porcentaje del equity al inicio del día. Nulo cuando la fase no tiene límite diario.

Elementos del array · string

string

maxTotalDrawdownstring[]obligatorio

Límite de drawdown total de la fase actual, en porcentaje del saldo inicial. Nulo cuando la fase no tiene límite total.

Elementos del array · string

string

maxTrailingTotalDrawdownstring[]obligatorio

Límite de drawdown móvil de la fase actual, en porcentaje del equity más alto alcanzado. Nulo cuando la fase no tiene límite móvil.

Elementos del array · string

string

drawdownBasestring · int32 · nullableobligatorio

Equity 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)$

Ejemplo: 1000000000

maxDrawdownStopstring · int32 · nullableobligatorio

Nivel 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)$

Ejemplo: 1000000000

minTradingDaysnumber[]obligatorio

Días de trading requeridos antes de que se pueda superar la fase actual. Nulo cuando la fase no tiene mínimo.

Elementos del array · number

number

suspendedUntilstring · date-time · nullableobligatorio

Cuándo se levanta una suspensión de la cuenta. Nulo cuando no está suspendida.

Ejemplo: 2023-10-01T00:00:00.000Z

accountBalancestring · int32obligatorio

Saldo sin el pnl no realizado de las posiciones abiertas, fp9 en bruto.

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

Ejemplo: 1000000000

initialAccountBalancestring · int32obligatorio

Saldo con el que se abrió la cuenta, fp9 en bruto — el tamaño nominal del desafío.

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

Ejemplo: 1000000000

maxEquitystring · int32 · nullableobligatorio

El 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)$

Ejemplo: 1000000000

dayStartEquitystring · int32 · nullableobligatorio

Equity con el que abrió el día de trading actual, fp9 en bruto.

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

Ejemplo: 1000000000

profitableDaysnumberobligatorio

Días rentables contados en el período de retiro actual.

Ejemplo: 0

prevPeriodProfitableDaysnumberobligatorio

Días rentables contados en el período de retiro anterior.

Ejemplo: 0

createdAtstring · date-timeobligatorio

Cuándo se creó la cuenta.

Ejemplo: 2026-05-01T12:30:00.000Z

failureReasonstring · enum · nullableobligatorio

Regla que hizo fallar la cuenta. Nulo mientras no haya fallado.

Permitido: "max_total_drawdown" "max_trailing_total_drawdown" "max_daily_drawdown" null

Ejemplo: max_total_drawdown

fundedAtstring · date-time · nullableobligatorio

Momento en que la cuenta alcanzó la fase financiada. Nulo antes de eso.

Ejemplo: 2026-05-01T12:30:00.000Z

failedAtstring · date-time · nullableobligatorio

Momento en que la cuenta falló. Nulo mientras no lo haya hecho.

Ejemplo: 2026-05-01T12:30:00.000Z

transitionReviewAtstring · date-time · nullableobligatorio

Momento en que se envió la transición de fase para revisión manual. Nulo cuando no hay ninguna revisión pendiente.

Ejemplo: 2026-05-01T12:30:00.000Z

currentWithdrawalPeriodStartedAtstring · date-time · nullableobligatorio

Inicio del período de retiro en curso. Nulo mientras no haya ninguno en curso.

Ejemplo: 2026-05-01T12:30:00.000Z

fundedLimitUnlockedAtstring · date-time · nullableobligatorio

Cuá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.

Ejemplo: 2026-05-01T12:30:00.000Z

maxWithdrawalAmountstring · int32obligatorio

Importe máximo que puede retirarse de la cuenta en este momento, fp9 en bruto.

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

Ejemplo: 1000000000

payoutBaselineBalancestring · int32obligatorio

Saldo 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)$

Ejemplo: 1000000000

isActiveWithdrawalInPeriodbooleanobligatorio

Indica si una solicitud de retirada ya está en curso para el período actual.

Ejemplo: true

profitSplitPercentnumberobligatorio

Participación del beneficio pagado al trader, en porcentaje.

Ejemplo: 80

debtstring · int32obligatorio

Deuda 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)$

Ejemplo: 1000000000

dailyDrawdownProtectionobject · nullableobligatorio

Protección diaria contra drawdown de la cuenta. Nula cuando la cuenta no tiene la opción.

Objeto · 1 campo

usedAtstring · date-time · nullableobligatorio

Cuándo se consumió la protección. Nula mientras siga disponible.

Ejemplo: 2026-05-01T12:30:00.000Z

Ver ejemplo

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

aiFailedReportbooleanobligatorio

Si se ha generado un informe automatizado para el fallo de esta cuenta.

Ejemplo: true

apiTradingbooleanobligatorio

Si la cuenta puede operarse con una clave API personal. Las solicitudes realizadas con una clave se rechazan en las cuentas donde esto es falso.

Ejemplo: true

availableMarketsstring · enumobligatorio

Categoría de mercado en la que la cuenta puede operar: crypto, rwa o all.

Permitido: "crypto" "rwa" "all"

Ejemplo: crypto

antifraudStatusstring · enumobligatorio

Estado antifraude de la cuenta; cualquier valor distinto de normal la marca para revisión.

Permitido: "normal" "test_account" "balance_exceeded" "manually_flagged" "manually_cleared"

Ejemplo: normal

tradingLockReasonstring[]obligatorio

Motivo 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.

Elementos del array · string

string

Ver ejemplo

[
  "string"
]

tournamentobject · nullableobligatorio

Torneo al que pertenece la cuenta. Nulo para cuentas fuera de un torneo.

Objeto · 5 campos

idstring · uuidobligatorio

Identificador 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})$

Ejemplo: 00000000-0000-4000-8000-000000000000

statusstring · enumobligatorio

Etapa en la que se encuentra el torneo.

Permitido: "active" "completed"

Ejemplo: active

startDatestring · date-timeobligatorio

Cuándo se abre el torneo para operar.

Ejemplo: 2026-05-01T12:30:00.000Z

endDatestring · date-timeobligatorio

Cuándo cierra el torneo.

Ejemplo: 2026-05-01T12:30:00.000Z

finalRecalcDonebooleanobligatorio

Si la clasificación final se ha recalculado después del cierre.

Ejemplo: true

Ver 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
}

restoreobjectobligatorio

Si una cuenta financiada fallida puede recuperarse y hasta cuándo.

Objeto · 2 campos

restoreAvailablebooleanobligatorio

Si la cuenta fondeada fallida puede restaurarse ahora mismo.

Ejemplo: true

restoreAvailableUntilstring · date-time · nullableobligatorio

Cuándo se cierra la ventana de restauración. Nulo cuando no hay ventana.

Ejemplo: 2026-05-01T12:30:00.000Z

Ver ejemplo

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

riskStatusobjectobligatorio

Instantánea de riesgo en vivo de esta cuenta, la misma carga útil que devuelven los endpoints de estado de riesgo.

Objeto · 15 campos

accountIdstring · uuidobligatorio

Cuenta 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})$

Ejemplo: 00000000-0000-4000-8000-000000000000

tradingDaysnumberobligatorio

Número de días en los que la cuenta ha operado — contabilizados frente a los días mínimos de trading del desafío.

Ejemplo: 0

currentBalancestring · int32obligatorio

Saldo de la cuenta sin el pnl no realizado de las posiciones abiertas, fp9 en bruto.

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

Ejemplo: 1000000000

currentEquitystring · int32obligatorio

Saldo 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)$

Ejemplo: 1000000000

dayStartEquitystring · int32obligatorio

Equity 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)$

Ejemplo: 1000000000

maxEquitystring · int32 · nullableobligatorio

Equity 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)$

Ejemplo: 1000000000

periodStartEquitystring · int32 · nullableobligatorio

Equity 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)$

Ejemplo: 1000000000

maxPeriodDailyEquityDeltastring · int32 · nullableobligatorio

Mayor 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)$

Ejemplo: 1000000000

maxPeriodDailyEquityDeltaAtstring · date-time · nullableobligatorio

Día que produjo maxPeriodDailyEquityDelta. Nulo junto con él.

Ejemplo: 2026-05-01T12:30:00.000Z

consistencyRuleAppliesbooleanobligatorio

Si la regla de consistencia es parte de las reglas de esta cuenta en su fase actual.

Ejemplo: true

consistencyRuleMetboolean · nullableobligatorio

Si la regla se cumple actualmente. Nulo mientras el período no esté en beneficio y el ratio no pueda calcularse.

Ejemplo: true

consistencyRuleRatiostring · int32 · nullableobligatorio

Proporció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)$

Ejemplo: 1000000000

consistencyRuleLimitstring · int32obligatorio

Mayor 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)$

Ejemplo: 1000000000

payoutBaselineBalancestring · int32obligatorio

Saldo 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)$

Ejemplo: 1000000000

isPayoutBaselineRequirementMetbooleanobligatorio

Si el capital está por encima de payoutBaselineBalance — la condición para ser elegible para solicitar un pago.

Ejemplo: true

Ver 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
}