Cancelar orden

Cancela una orden existente identificada por su ID interno.

DELETE/v1/broker/orders/cancel/{order-id}

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN

Path Parameters

Campo	Tipo	Requerido	Descripción
order-id	integer	Sí	Identificador interno de la orden a cancelar.

No aplica: Query Parameters, Body.

Response

2XX Éxito

Campo	Tipo	Descripción
status_code	string	Resultado de la cancelación. Valor posible: CANCELLED.
message	string	Descripción legible del resultado.

Códigos de error

Status	Descripción
400	Bad Request — no existe ninguna orden con el order-id indicado, la orden ya fue procesada y no puede cancelarse, o el mercado rechazó la cancelación
401	Unauthorized — token de acceso inválido o faltante
403	Forbidden — el token no tiene permiso para acceder a este recurso
500	Internal Server Error

Estructura del error:

{
  "code": "invalid_request",
  "description": "Order with ID: 984512 is already processed and has the following state: FILLED"
}

Ejemplo de código

cURL

curl -X DELETE https://b2b.allaria.dev/v1/broker/orders/cancel/984512 \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const orderId = 984512;

const response = await fetch(
  `https://b2b.allaria.dev/v1/broker/orders/cancel/${orderId}`,
  {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
  }
);
const data = await response.json();
console.log(data);

Python

import requests

order_id = 984512

response = requests.delete(
  f'https://b2b.allaria.dev/v1/broker/orders/cancel/{order_id}',
  headers={ 'Authorization': 'Bearer ACCESS_TOKEN' }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const orderId = 984512;

const response = await axios.delete(
  `https://b2b.allaria.dev/v1/broker/orders/cancel/${orderId}`,
  { headers: { Authorization: 'Bearer ACCESS_TOKEN' } }
);
console.log(response.data);

2XX Éxito

{
  "status_code": "CANCELLED",
  "message": "The order was cancelled successfully."
}