# Obtener el historial de capital de la cuenta del trader

`GET /accounts/{accountId}/equity-history`

Capital de la cuenta muestreado una vez por minuto, primero el más antiguo.

- La ventana se establece mediante `timestamp` y `duration`; si no se proporciona ninguno, cubre los últimos 5 días y termina con el saldo en vivo añadido como punto final.
- En una cuenta fallida, la ventana se ancla al momento en que la cuenta falló, por lo que la serie nunca lo sobrepasa.

<a id="authorization"></a>

## Autorización

bearer: http · bearer (obligatorio). Clave de API personal, con el prefijo `usk_`.

<a id="parameters"></a>

## Parámetros

- path: accountId (string · uuid; obligatorio). Identificador de la cuenta del trader. Debe pertenecer al solicitante.

Tipo: string · uuid

format: uuid

- query: timestamp (number; opcional). Ancla de la ventana, marca de tiempo unix en milisegundos. Omitido: la ventana termina en el momento actual (o en el momento en que la cuenta falló) y el saldo en vivo se añade como el último punto.

Tipo: number

Ejemplo: 1767225599000

- query: duration (number; opcional). Longitud de la ventana en milisegundos, 5 días por defecto. Positivo: la ventana comienza en `timestamp` y se extiende hacia adelante. Negativo: la ventana termina en `timestamp` (o ahora) y se extiende hacia atrás. Cero se rechaza.

Tipo: number

Ejemplo: -86400000

<a id="example-curl"></a>

## Ejemplo · cURL

```bash
curl --request GET 'https://api.upscale.trade/accounts/{accountId}/equity-history' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

<a id="example-javascript"></a>

## Ejemplo · JavaScript

```javascript
const response = await fetch("https://api.upscale.trade/accounts/{accountId}/equity-history", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
});
console.log(response.status, await response.text());
```

<a id="example-python"></a>

## Ejemplo · Python

```python
import requests

response = requests.request(
    "GET",
    "https://api.upscale.trade/accounts/{accountId}/equity-history",
    headers={"Accept":"application/json","Authorization":"Bearer YOUR_API_KEY"},
    timeout=30,
)
print(response.status_code, response.text)
```

<a id="response-200-accountsequityhistoryresponse"></a>

## Respuesta 200 · AccountsEquityHistoryResponse

**200** application/json — Respuesta

Tipo: object[]

[]Esquema: AccountsEquityHistoryResponse

[]Tipo: object

[]Campos obligatorios: timestamp, volume, phaseIndex, phaseStartEquity

[]Tipos de campos obligatorios: timestamp (number; obligatorio), volume (string; obligatorio), phaseIndex (integer; obligatorio), phaseStartEquity (string; obligatorio)

- []timestamp (number; obligatorio)

[]timestamp ejemplo: 1767225599000

[]timestamp.Tipo: number

[]timestamp.Minuto al que pertenece la muestra, marca de tiempo Unix en milisegundos.

- []volume (string; obligatorio)

[]volume ejemplo: 10000000000000

[]volume.Tipo: string

[]volume.Capital de la cuenta en ese minuto — saldo más pnl no realizado de posiciones abiertas, fp9 en bruto.

- []phaseIndex (integer; obligatorio)

[]phaseIndex ejemplo: 1

[]phaseIndex.Tipo: integer

[]phaseIndex.Índice de fase de trading al que pertenece la muestra.

[]phaseIndex.minimum: 0

[]phaseIndex.maximum: 9007199254740991

- []phaseStartEquity (string; obligatorio)

[]phaseStartEquity ejemplo: 10000000000000

[]phaseStartEquity.Tipo: string

[]phaseStartEquity.Capital inicial de la fase de trading de la muestra, fp9 en bruto.

Ejemplo



```json
[
  {
    "timestamp": 1767225599000,
    "volume": "10000000000000",
    "phaseIndex": 1,
    "phaseStartEquity": "10000000000000"
  }
]
```

<a id="response-401"></a>

## Respuesta 401

**401**  — No autorizado

<a id="response-403"></a>

## Respuesta 403

**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`).

<a id="response-404"></a>

## Respuesta 404

**404**  — No hay ninguna cuenta con este identificador.

<a id="response-429"></a>

## Respuesta 429

**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`.