Cerrar todas las posiciones y órdenes

POST/accounts/{accountId}/close-all

Cerrar todas las posiciones y órdenesCuentas

Cancela cada orden activa en la cuenta y luego cierra cada posición abierta a mercado.

Responde 204 sin cuerpo; las ejecuciones resultantes aparecen en el historial de posiciones y en los eventos de la cuenta.
Envía un encabezado x-idempotency-key para que la llamada sea segura frente a repeticiones: dentro de la ventana de repetición indicada en ese encabezado, la misma clave en la misma ruta reproduce la respuesta almacenada (marcada con X-Idempotency-Cached: true y X-Idempotency-Timestamp) en lugar de actuar de nuevo, y una segunda llamada que llegue mientras la primera aún se está ejecutando recibe 409 (idempotency_key_in_flight).

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

Cabecera

x-idempotency-keystringopcional

Clave de idempotencia — cualquier cadena opaca, un uuid v4 funciona bien. Repetir la llamada con la misma clave en esta ruta dentro de 1 minuto reproduce la respuesta almacenada en lugar de actuar de nuevo; una repetición lleva X-Idempotency-Cached: true y X-Idempotency-Timestamp. Omite el encabezado para optar por no participar.

Ejemplo: 9f1c2b7e-5a3d-4f61-9b0e-2c7d4a8e1f35

Ejemplos

curl --request POST 'https://api.upscale.trade/accounts/{accountId}/close-all' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

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

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

Respuestas

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.

409

Otra llamada con la misma x-idempotency-key sigue en ejecución (idempotency_key_in_flight). Reintenta cuando haya terminado.

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.