Upscale
Menu
On this page

Obtener el historial de capital de la cuenta del trader

Probar ↓
GET/accounts/{accountId}/equity-history
Obtener el historial de capital de la cuenta del traderCuentas

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.
URL base https://api.upscale.trade

Autorización

bearerhttp · bearerobligatorio

Clave de API personal, con el prefijo usk_.

Parámetros

Ruta
accountIdstring · uuidobligatorio

Identificador de la cuenta del trader. Debe pertenecer al solicitante.

Ejemplo: 00000000-0000-4000-8000-000000000000
Consulta
timestampnumberopcional

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.

Ejemplo: 1767225599000
durationnumberopcional

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.

Ejemplo: -86400000

Ejemplos

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

Respuestas

200Respuestaapplication/json

Array de AccountsEquityHistoryResponse

timestampnumberobligatorio

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

Ejemplo: 1767225599000
volumestringobligatorio

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

Ejemplo: 10000000000000
phaseIndexintegerobligatorio

Índice de fase de trading al que pertenece la muestra.

minimum
0
maximum
9007199254740991
Ejemplo: 1
phaseStartEquitystringobligatorio

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

Ejemplo: 10000000000000
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.