Obtener el estado de riesgo de todas las cuentas del usuario actual.

GET/accounts/risk-status

Obtener el estado de riesgo de todas las cuentas del usuario actual.Cuentas

La instantánea de riesgo por cuenta, para todas las cuentas del solicitante a la vez.

Autenticado con una clave de API, solo se incluyen las cuentas que tienen api_trading habilitado.
Las sesiones interactivas comparten un presupuesto aquí con el estado de riesgo de una sola cuenta; 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/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)

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

Array de AccountsRiskStatusResponse

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[]obligatorio

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

Elementos del array · boolean

boolean

Ver 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

[
  {
    "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
  }
]