{"format":"opendoc-document","version":1,"url":"https://docs.upscale.trade/es/developers/operations/getaccountriskstatus","title":"Obtener el estado de riesgo de la cuenta del trader","description":"GET /accounts/{accountId}/risk-status: La 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…","kind":"api-operation","locale":"es","inLanguage":"es","translation":{"sourceLanguage":"en","targetLanguage":"es","status":"complete","translatedUnits":28,"totalUnits":28},"lastModified":"2026-09-28T20:05:09.350Z","revision":"3c2fd254d25c5fe88817d5c939afd24407f25862bdfb7b9dc8ab5105728c7abe","section":{"title":"Developers","url":"https://docs.upscale.trade/es/developers"},"representations":{"html":"https://docs.upscale.trade/es/developers/operations/getaccountriskstatus","markdown":"https://docs.upscale.trade/es/developers/operations/getaccountriskstatus.md","json":"https://docs.upscale.trade/es/developers/operations/getaccountriskstatus.json"},"translations":{"en":"https://docs.upscale.trade/developers/operations/getaccountriskstatus","ru":"https://docs.upscale.trade/ru/developers/operations/getaccountriskstatus","es":"https://docs.upscale.trade/es/developers/operations/getaccountriskstatus"},"operation":{"id":"getAccountRiskStatus","method":"GET","path":"/accounts/{accountId}/risk-status","summary":"Obtener el estado de riesgo de la cuenta del trader","description":"La 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,\nel estado de la regla de consistencia y la línea base de payout.\n\n- Se lee en vivo desde el shard que aloja la cuenta, por lo que las posiciones abiertas ya están reflejadas en el equity.\n- 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.","tags":["Accounts"],"tagLabels":{"Accounts":"Cuentas","Config":"Configuración","Trading":"Trading"},"deprecated":false,"parameters":[{"name":"accountId","location":"path","schema":{"type":"string · uuid","types":["string"],"nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"uuid"},"properties":[],"variants":[]},"type":"string · uuid","required":true,"description":"Identificador de la cuenta del trader. Debe pertenecer al solicitante.","example":"00000000-0000-4000-8000-000000000000"}],"bodies":[],"responses":[{"status":"200","description":"Respuesta","mediaType":"application/json","properties":[{"name":"accountId","type":"string · uuid","required":true,"description":"Trader account the snapshot belongs to.","example":"00000000-0000-4000-8000-000000000000","schema":{"type":"string · uuid","types":["string"],"description":"Trader account the snapshot belongs to.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"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})$"},"properties":[],"variants":[]}},{"name":"tradingDays","type":"number","required":true,"description":"Number of days the account has traded on — counted against the minimum trading days of the challenge.","example":"0","schema":{"type":"number","types":["number"],"description":"Number of days the account has traded on — counted against the minimum trading days of the challenge.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"variants":[]}},{"name":"currentBalance","type":"string · int32","required":true,"description":"Account balance without the unrealised pnl of open positions, fp9 raw.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"Account balance without the unrealised pnl of open positions, fp9 raw.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"currentEquity","type":"string · int32","required":true,"description":"Balance plus the unrealised pnl of open positions, fp9 raw. This is what drawdown rules are measured against.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"Balance plus the unrealised pnl of open positions, fp9 raw. This is what drawdown rules are measured against.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"dayStartEquity","type":"string · int32","required":true,"description":"Equity the current trading day opened at, fp9 raw — the base of the daily drawdown limit.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"Equity the current trading day opened at, fp9 raw — the base of the daily drawdown limit.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"maxEquity","type":"string · int32 · nullable","required":true,"description":"Highest equity the account has ever reached, fp9 raw — the base of the trailing drawdown. Null before the first trade.","example":"1000000000","schema":{"type":"string · int32 · nullable","types":["string"],"description":"Highest equity the account has ever reached, fp9 raw — the base of the trailing drawdown. Null before the first trade.","example":"1000000000","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"periodStartEquity","type":"string · int32 · nullable","required":true,"description":"Equity the current withdrawal period opened at, fp9 raw. Null while no period is running.","example":"1000000000","schema":{"type":"string · int32 · nullable","types":["string"],"description":"Equity the current withdrawal period opened at, fp9 raw. Null while no period is running.","example":"1000000000","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"maxPeriodDailyEquityDelta","type":"string · int32 · nullable","required":true,"description":"Largest single-day equity gain inside the current period, fp9 raw — the numerator of the consistency rule. Null while no day has closed in profit.","example":"1000000000","schema":{"type":"string · int32 · nullable","types":["string"],"description":"Largest single-day equity gain inside the current period, fp9 raw — the numerator of the consistency rule. Null while no day has closed in profit.","example":"1000000000","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"maxPeriodDailyEquityDeltaAt","type":"string · date-time · nullable","required":true,"description":"Day that produced `maxPeriodDailyEquityDelta`. Null together with it.","example":"2026-05-01T12:30:00.000Z","schema":{"type":"string · date-time · nullable","types":["string"],"description":"Day that produced `maxPeriodDailyEquityDelta`. Null together with it.","example":"2026-05-01T12:30:00.000Z","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"date-time"},"properties":[],"variants":[]}},{"name":"consistencyRuleApplies","type":"boolean","required":true,"description":"Whether the consistency rule is part of the rules of this account in its current phase.","example":"true","schema":{"type":"boolean","types":["boolean"],"description":"Whether the consistency rule is part of the rules of this account in its current phase.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"variants":[]}},{"name":"consistencyRuleMet","type":"boolean[]","required":true,"description":"Whether the rule is currently satisfied. Null while the period is not in profit and the ratio cannot be computed.","example":"[\n  true\n]","schema":{"type":"boolean[]","types":["array"],"description":"Whether the rule is currently satisfied. Null while the period is not in profit and the ratio cannot be computed.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"items":{"type":"boolean","types":["boolean"],"nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"variants":[]},"variants":[]}},{"name":"consistencyRuleRatio","type":"string · int32 · nullable","required":true,"description":"Share of the period profit made on its best day, fp9 raw fraction. Null together with `consistencyRuleMet`.","example":"1000000000","schema":{"type":"string · int32 · nullable","types":["string"],"description":"Share of the period profit made on its best day, fp9 raw fraction. Null together with `consistencyRuleMet`.","example":"1000000000","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"consistencyRuleLimit","type":"string · int32","required":true,"description":"Largest share of period profit one day may account for, fp9 raw fraction (`300000000` = 30%). A ratio above it fails the rule.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"Largest share of period profit one day may account for, fp9 raw fraction (`300000000` = 30%). A ratio above it fails the rule.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"payoutBaselineBalance","type":"string · int32","required":true,"description":"Balance the next payout is measured from, fp9 raw. Equal to the initial account size until the first payout moves it.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"Balance the next payout is measured from, fp9 raw. Equal to the initial account size until the first payout moves it.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"isPayoutBaselineRequirementMet","type":"boolean","required":true,"description":"Whether equity is above `payoutBaselineBalance` — the condition for being eligible to request a payout.","example":"true","schema":{"type":"boolean","types":["boolean"],"description":"Whether equity is above `payoutBaselineBalance` — the condition for being eligible to request a payout.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"variants":[]}}],"schema":{"type":"object","types":["object"],"reference":"#/components/schemas/AccountsRiskStatusResponse","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[{"name":"accountId","type":"string · uuid","required":true,"description":"Cuenta de trader a la que pertenece la instantánea.","example":"00000000-0000-4000-8000-000000000000","schema":{"type":"string · uuid","types":["string"],"description":"Cuenta de trader a la que pertenece la instantánea.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"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})$"},"properties":[],"variants":[]}},{"name":"tradingDays","type":"number","required":true,"description":"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.","example":"0","schema":{"type":"number","types":["number"],"description":"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.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"variants":[]}},{"name":"currentBalance","type":"string · int32","required":true,"description":"Saldo de la cuenta sin el pnl no realizado de las posiciones abiertas, fp9 en bruto.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"Saldo de la cuenta sin el pnl no realizado de las posiciones abiertas, fp9 en bruto.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"currentEquity","type":"string · int32","required":true,"description":"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.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"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.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"dayStartEquity","type":"string · int32","required":true,"description":"Equity con el que abrió el día de trading actual, fp9 en bruto — la base del límite de drawdown diario.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"Equity con el que abrió el día de trading actual, fp9 en bruto — la base del límite de drawdown diario.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"maxEquity","type":"string · int32 · nullable","required":true,"description":"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.","example":"1000000000","schema":{"type":"string · int32 · nullable","types":["string"],"description":"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.","example":"1000000000","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"periodStartEquity","type":"string · int32 · nullable","required":true,"description":"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.","example":"1000000000","schema":{"type":"string · int32 · nullable","types":["string"],"description":"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.","example":"1000000000","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"maxPeriodDailyEquityDelta","type":"string · int32 · nullable","required":true,"description":"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.","example":"1000000000","schema":{"type":"string · int32 · nullable","types":["string"],"description":"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.","example":"1000000000","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"maxPeriodDailyEquityDeltaAt","type":"string · date-time · nullable","required":true,"description":"Día que produjo `maxPeriodDailyEquityDelta`. Nulo junto con él.","example":"2026-05-01T12:30:00.000Z","schema":{"type":"string · date-time · nullable","types":["string"],"description":"Día que produjo `maxPeriodDailyEquityDelta`. Nulo junto con él.","example":"2026-05-01T12:30:00.000Z","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"date-time"},"properties":[],"variants":[]}},{"name":"consistencyRuleApplies","type":"boolean","required":true,"description":"Si la regla de consistencia es parte de las reglas de esta cuenta en su fase actual.","example":"true","schema":{"type":"boolean","types":["boolean"],"description":"Si la regla de consistencia es parte de las reglas de esta cuenta en su fase actual.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"variants":[]}},{"name":"consistencyRuleMet","type":"boolean[]","required":true,"description":"Si la regla se cumple actualmente. Nulo mientras el período no esté en beneficio y el ratio no pueda calcularse.","example":"[\n  true\n]","schema":{"type":"boolean[]","types":["array"],"description":"Si la regla se cumple actualmente. Nulo mientras el período no esté en beneficio y el ratio no pueda calcularse.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"items":{"type":"boolean","types":["boolean"],"nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"variants":[]},"variants":[]}},{"name":"consistencyRuleRatio","type":"string · int32 · nullable","required":true,"description":"Proporción del beneficio del período obtenido en su mejor día, fp9 fracción en bruto. Nulo junto con `consistencyRuleMet`.","example":"1000000000","schema":{"type":"string · int32 · nullable","types":["string"],"description":"Proporción del beneficio del período obtenido en su mejor día, fp9 fracción en bruto. Nulo junto con `consistencyRuleMet`.","example":"1000000000","nullable":true,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"consistencyRuleLimit","type":"string · int32","required":true,"description":"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.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"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.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"payoutBaselineBalance","type":"string · int32","required":true,"description":"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.","example":"1000000000","schema":{"type":"string · int32","types":["string"],"description":"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.","example":"1000000000","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{"format":"int32","pattern":"^(?:-?[1-9][0-9]*|0)$"},"properties":[],"variants":[]}},{"name":"isPayoutBaselineRequirementMet","type":"boolean","required":true,"description":"Si el capital está por encima de `payoutBaselineBalance` — la condición para ser elegible para solicitar un pago.","example":"true","schema":{"type":"boolean","types":["boolean"],"description":"Si el capital está por encima de `payoutBaselineBalance` — la condición para ser elegible para solicitar un pago.","nullable":false,"readOnly":false,"writeOnly":false,"constraints":{},"properties":[],"variants":[]}}],"variants":[]},"example":"{\n  \"accountId\": \"00000000-0000-4000-8000-000000000000\",\n  \"tradingDays\": 0,\n  \"currentBalance\": \"1000000000\",\n  \"currentEquity\": \"1000000000\",\n  \"dayStartEquity\": \"1000000000\",\n  \"maxEquity\": \"1000000000\",\n  \"periodStartEquity\": \"1000000000\",\n  \"maxPeriodDailyEquityDelta\": \"1000000000\",\n  \"maxPeriodDailyEquityDeltaAt\": \"2026-05-01T12:30:00.000Z\",\n  \"consistencyRuleApplies\": true,\n  \"consistencyRuleMet\": [\n    true\n  ],\n  \"consistencyRuleRatio\": \"1000000000\",\n  \"consistencyRuleLimit\": \"1000000000\",\n  \"payoutBaselineBalance\": \"1000000000\",\n  \"isPayoutBaselineRequirementMet\": true\n}","headers":[]},{"status":"401","description":"No autorizado","properties":[],"headers":[]},{"status":"403","description":"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`).","properties":[],"headers":[]},{"status":"404","description":"No hay ninguna cuenta con este identificador.","properties":[],"headers":[]},{"status":"429","description":"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`.","properties":[],"headers":[]}],"security":[{"name":"bearer","type":"http · bearer","description":"Clave de API personal, con el prefijo `usk_`.","required":true,"scopes":[]}],"codeSamples":[{"label":"cURL","language":"bash","source":"curl --request GET 'https://api.upscale.trade/accounts/{accountId}/risk-status' \\\n  --header 'Accept: application/json' \\\n  --header 'Authorization: Bearer YOUR_API_KEY'"},{"label":"JavaScript","language":"javascript","source":"const response = await fetch(\"https://api.upscale.trade/accounts/{accountId}/risk-status\", {\n  method: \"GET\",\n  headers: {\n    \"Accept\": \"application/json\",\n    \"Authorization\": \"Bearer YOUR_API_KEY\"\n  },\n});\nconsole.log(response.status, await response.text());"},{"label":"Python","language":"python","source":"import requests\n\nresponse = requests.request(\n    \"GET\",\n    \"https://api.upscale.trade/accounts/{accountId}/risk-status\",\n    headers={\"Accept\":\"application/json\",\"Authorization\":\"Bearer YOUR_API_KEY\"},\n    timeout=30,\n)\nprint(response.status_code, response.text)"}]},"breadcrumbs":[{"title":"Qué es el prop trading","url":"https://docs.upscale.trade/es"},{"title":"Developers","url":"https://docs.upscale.trade/es/developers"},{"title":"Obtener el estado de riesgo de la cuenta del trader","url":"https://docs.upscale.trade/es/developers/operations/getaccountriskstatus"}],"headings":[{"depth":2,"id":"authorization","title":"Autorización"},{"depth":2,"id":"parameters","title":"Parámetros"},{"depth":2,"id":"examples","title":"Ejemplos"},{"depth":2,"id":"responses","title":"Respuestas"}],"markdown":"# Obtener el estado de riesgo de la cuenta del trader\n\n`GET /accounts/{accountId}/risk-status`\n\nLa 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,\nel estado de la regla de consistencia y la línea base de payout.\n\n- Se lee en vivo desde el shard que aloja la cuenta, por lo que las posiciones abiertas ya están reflejadas en el equity.\n- 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.\n\n<a id=\"authorization\"></a>\n\n## Autorización\n\nbearer: http · bearer (obligatorio). Clave de API personal, con el prefijo `usk_`.\n\n<a id=\"parameters\"></a>\n\n## Parámetros\n\n- path: accountId (string · uuid; obligatorio). Identificador de la cuenta del trader. Debe pertenecer al solicitante.\n\nTipo: string · uuid\n\nformat: uuid\n\n<a id=\"example-curl\"></a>\n\n## Ejemplo · cURL\n\n```bash\ncurl --request GET 'https://api.upscale.trade/accounts/{accountId}/risk-status' \\\n  --header 'Accept: application/json' \\\n  --header 'Authorization: Bearer YOUR_API_KEY'\n```\n\n<a id=\"example-javascript\"></a>\n\n## Ejemplo · JavaScript\n\n```javascript\nconst response = await fetch(\"https://api.upscale.trade/accounts/{accountId}/risk-status\", {\n  method: \"GET\",\n  headers: {\n    \"Accept\": \"application/json\",\n    \"Authorization\": \"Bearer YOUR_API_KEY\"\n  },\n});\nconsole.log(response.status, await response.text());\n```\n\n<a id=\"example-python\"></a>\n\n## Ejemplo · Python\n\n```python\nimport requests\n\nresponse = requests.request(\n    \"GET\",\n    \"https://api.upscale.trade/accounts/{accountId}/risk-status\",\n    headers={\"Accept\":\"application/json\",\"Authorization\":\"Bearer YOUR_API_KEY\"},\n    timeout=30,\n)\nprint(response.status_code, response.text)\n```\n\n<a id=\"response-200-accountsriskstatusresponse\"></a>\n\n## Respuesta 200 · AccountsRiskStatusResponse\n\n**200** application/json — Respuesta\n\nEsquema: AccountsRiskStatusResponse\n\nTipo: object\n\nCampos obligatorios: accountId, tradingDays, currentBalance, currentEquity, dayStartEquity, maxEquity, periodStartEquity, maxPeriodDailyEquityDelta, maxPeriodDailyEquityDeltaAt, consistencyRuleApplies, consistencyRuleMet, consistencyRuleRatio, consistencyRuleLimit, payoutBaselineBalance, isPayoutBaselineRequirementMet\n\nTipos de campos obligatorios: accountId (string · uuid; obligatorio), tradingDays (number; obligatorio), currentBalance (string · int32; obligatorio), currentEquity (string · int32; obligatorio), dayStartEquity (string · int32; obligatorio), maxEquity (string · int32 · nullable; obligatorio), periodStartEquity (string · int32 · nullable; obligatorio), maxPeriodDailyEquityDelta (string · int32 · nullable; obligatorio), maxPeriodDailyEquityDeltaAt (string · date-time · nullable; obligatorio), consistencyRuleApplies (boolean; obligatorio), consistencyRuleMet (boolean[]; obligatorio), consistencyRuleRatio (string · int32 · nullable; obligatorio), consistencyRuleLimit (string · int32; obligatorio), payoutBaselineBalance (string · int32; obligatorio), isPayoutBaselineRequirementMet (boolean; obligatorio)\n\n- accountId (string · uuid; obligatorio)\n\naccountId ejemplo: 00000000-0000-4000-8000-000000000000\n\naccountId.Tipo: string · uuid\n\naccountId.Cuenta de trader a la que pertenece la instantánea.\n\naccountId.format: uuid\n\naccountId.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})$\n\n- tradingDays (number; obligatorio)\n\ntradingDays ejemplo: 0\n\ntradingDays.Tipo: number\n\ntradingDays.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.\n\n- currentBalance (string · int32; obligatorio)\n\ncurrentBalance ejemplo: 1000000000\n\ncurrentBalance.Tipo: string · int32\n\ncurrentBalance.Saldo de la cuenta sin el pnl no realizado de las posiciones abiertas, fp9 en bruto.\n\ncurrentBalance.format: int32\n\ncurrentBalance.pattern: ^(?:-?[1-9][0-9]*|0)$\n\n- currentEquity (string · int32; obligatorio)\n\ncurrentEquity ejemplo: 1000000000\n\ncurrentEquity.Tipo: string · int32\n\ncurrentEquity.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.\n\ncurrentEquity.format: int32\n\ncurrentEquity.pattern: ^(?:-?[1-9][0-9]*|0)$\n\n- dayStartEquity (string · int32; obligatorio)\n\ndayStartEquity ejemplo: 1000000000\n\ndayStartEquity.Tipo: string · int32\n\ndayStartEquity.Equity con el que abrió el día de trading actual, fp9 en bruto — la base del límite de drawdown diario.\n\ndayStartEquity.format: int32\n\ndayStartEquity.pattern: ^(?:-?[1-9][0-9]*|0)$\n\n- maxEquity (string · int32 · nullable; obligatorio)\n\nmaxEquity ejemplo: 1000000000\n\nmaxEquity.Tipo: string · int32 · nullable\n\nmaxEquity.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.\n\nmaxEquity.format: int32\n\nmaxEquity.pattern: ^(?:-?[1-9][0-9]*|0)$\n\n- periodStartEquity (string · int32 · nullable; obligatorio)\n\nperiodStartEquity ejemplo: 1000000000\n\nperiodStartEquity.Tipo: string · int32 · nullable\n\nperiodStartEquity.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.\n\nperiodStartEquity.format: int32\n\nperiodStartEquity.pattern: ^(?:-?[1-9][0-9]*|0)$\n\n- maxPeriodDailyEquityDelta (string · int32 · nullable; obligatorio)\n\nmaxPeriodDailyEquityDelta ejemplo: 1000000000\n\nmaxPeriodDailyEquityDelta.Tipo: string · int32 · nullable\n\nmaxPeriodDailyEquityDelta.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.\n\nmaxPeriodDailyEquityDelta.format: int32\n\nmaxPeriodDailyEquityDelta.pattern: ^(?:-?[1-9][0-9]*|0)$\n\n- maxPeriodDailyEquityDeltaAt (string · date-time · nullable; obligatorio)\n\nmaxPeriodDailyEquityDeltaAt ejemplo: 2026-05-01T12:30:00.000Z\n\nmaxPeriodDailyEquityDeltaAt.Tipo: string · date-time · nullable\n\nmaxPeriodDailyEquityDeltaAt.Día que produjo `maxPeriodDailyEquityDelta`. Nulo junto con él.\n\nmaxPeriodDailyEquityDeltaAt.format: date-time\n\n- consistencyRuleApplies (boolean; obligatorio)\n\nconsistencyRuleApplies ejemplo: true\n\nconsistencyRuleApplies.Tipo: boolean\n\nconsistencyRuleApplies.Si la regla de consistencia es parte de las reglas de esta cuenta en su fase actual.\n\n- consistencyRuleMet (boolean[]; obligatorio)\n\nconsistencyRuleMet ejemplo: [\n  true\n]\n\nconsistencyRuleMet.Tipo: boolean[]\n\nconsistencyRuleMet.Si la regla se cumple actualmente. Nulo mientras el período no esté en beneficio y el ratio no pueda calcularse.\n\nconsistencyRuleMet.[]Tipo: boolean\n\n- consistencyRuleRatio (string · int32 · nullable; obligatorio)\n\nconsistencyRuleRatio ejemplo: 1000000000\n\nconsistencyRuleRatio.Tipo: string · int32 · nullable\n\nconsistencyRuleRatio.Proporción del beneficio del período obtenido en su mejor día, fp9 fracción en bruto. Nulo junto con `consistencyRuleMet`.\n\nconsistencyRuleRatio.format: int32\n\nconsistencyRuleRatio.pattern: ^(?:-?[1-9][0-9]*|0)$\n\n- consistencyRuleLimit (string · int32; obligatorio)\n\nconsistencyRuleLimit ejemplo: 1000000000\n\nconsistencyRuleLimit.Tipo: string · int32\n\nconsistencyRuleLimit.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.\n\nconsistencyRuleLimit.format: int32\n\nconsistencyRuleLimit.pattern: ^(?:-?[1-9][0-9]*|0)$\n\n- payoutBaselineBalance (string · int32; obligatorio)\n\npayoutBaselineBalance ejemplo: 1000000000\n\npayoutBaselineBalance.Tipo: string · int32\n\npayoutBaselineBalance.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.\n\npayoutBaselineBalance.format: int32\n\npayoutBaselineBalance.pattern: ^(?:-?[1-9][0-9]*|0)$\n\n- isPayoutBaselineRequirementMet (boolean; obligatorio)\n\nisPayoutBaselineRequirementMet ejemplo: true\n\nisPayoutBaselineRequirementMet.Tipo: boolean\n\nisPayoutBaselineRequirementMet.Si el capital está por encima de `payoutBaselineBalance` — la condición para ser elegible para solicitar un pago.\n\nEjemplo\n\n\n\n```json\n{\n  \"accountId\": \"00000000-0000-4000-8000-000000000000\",\n  \"tradingDays\": 0,\n  \"currentBalance\": \"1000000000\",\n  \"currentEquity\": \"1000000000\",\n  \"dayStartEquity\": \"1000000000\",\n  \"maxEquity\": \"1000000000\",\n  \"periodStartEquity\": \"1000000000\",\n  \"maxPeriodDailyEquityDelta\": \"1000000000\",\n  \"maxPeriodDailyEquityDeltaAt\": \"2026-05-01T12:30:00.000Z\",\n  \"consistencyRuleApplies\": true,\n  \"consistencyRuleMet\": [\n    true\n  ],\n  \"consistencyRuleRatio\": \"1000000000\",\n  \"consistencyRuleLimit\": \"1000000000\",\n  \"payoutBaselineBalance\": \"1000000000\",\n  \"isPayoutBaselineRequirementMet\": true\n}\n```\n\n<a id=\"response-401\"></a>\n\n## Respuesta 401\n\n**401**  — No autorizado\n\n<a id=\"response-403\"></a>\n\n## Respuesta 403\n\n**403**  — 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`).\n\n<a id=\"response-404\"></a>\n\n## Respuesta 404\n\n**404**  — No hay ninguna cuenta con este identificador.\n\n<a id=\"response-429\"></a>\n\n## Respuesta 429\n\n**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`.","text":"Obtener el estado de riesgo de la cuenta del trader La 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. GET /accounts/{accountId}/risk-status Accounts accountId Identificador de la cuenta del trader. Debe pertenecer al solicitante. string · uuid 200 Respuesta accountId Trader account the snapshot belongs to. string · uuid tradingDays Number of days the account has traded on — counted against the minimum trading days of the challenge. number currentBalance Account balance without the unrealised pnl of open positions, fp9 raw. string · int32 currentEquity Balance plus the unrealised pnl of open positions, fp9 raw. This is what drawdown rules are measured against. string · int32 dayStartEquity Equity the current trading day opened at, fp9 raw — the base of the daily drawdown limit. string · int32 maxEquity Highest equity the account has ever reached, fp9 raw — the base of the trailing drawdown. Null before the first trade. string · int32 · nullable periodStartEquity Equity the current withdrawal period opened at, fp9 raw. Null while no period is running. string · int32 · nullable maxPeriodDailyEquityDelta Largest single-day equity gain inside the current period, fp9 raw — the numerator of the consistency rule. Null while no day has closed in profit. string · int32 · nullable maxPeriodDailyEquityDeltaAt Day that produced `maxPeriodDailyEquityDelta`. Null together with it. string · date-time · nullable consistencyRuleApplies Whether the consistency rule is part of the rules of this account in its current phase. boolean consistencyRuleMet Whether the rule is currently satisfied. Null while the period is not in profit and the ratio cannot be computed. boolean[] consistencyRuleRatio Share of the period profit made on its best day, fp9 raw fraction. Null together with `consistencyRuleMet`. string · int32 · nullable consistencyRuleLimit Largest share of period profit one day may account for, fp9 raw fraction (`300000000` = 30%). A ratio above it fails the rule. string · int32 payoutBaselineBalance Balance the next payout is measured from, fp9 raw. Equal to the initial account size until the first payout moves it. string · int32 isPayoutBaselineRequirementMet Whether equity is above `payoutBaselineBalance` — the condition for being eligible to request a payout. boolean 401 No autorizado 403 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`). 404 No hay ninguna cuenta con este identificador. 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`.","api":{"title":"API pública de Upscale","version":"d796ac9","documentation":"https://docs.upscale.trade/es/developers","playgroundServer":"https://api.upscale.trade"}}