Editar orden

Edita la cantidad, el monto, el precio límite o el precio de disparo de una orden pendiente existente.

PUT/v1/broker/orders/edit/{order-id}

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN
Content-Type	string	Sí	Debe ser application/json

Path Parameters

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

No aplica: Query Parameters.

Body

Todos los campos son opcionales

Incluí solo los campos que querés modificar. stop_price solo aplica a órdenes stop-limit.

Campo	Tipo	Requerido	Descripción
quantity	number	No	Nueva cantidad de nominales para la orden.
limit_price	number	No	Nuevo precio límite para la orden.
amount	number	No	Nuevo monto para la orden.
stop_price	number	No	Nuevo precio de disparo para la orden. Solo válido para órdenes stop-limit.

Response

2XX Éxito

Campo	Tipo	Descripción
status	string	Resultado de la edición. Valores posibles: OK, ERROR.
description	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 no está en un estado que permita edición, o los nuevos valores son inválidos
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 984512 not found"
}

Ejemplo de código

cURL

curl -X PUT https://b2b.allaria.dev/v1/broker/orders/edit/984512 \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 100.0
  }'

JavaScript

const orderId = 984512;

const response = await fetch(
  `https://b2b.allaria.dev/v1/broker/orders/edit/${orderId}`,
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ quantity: 100.0 })
  }
);

const data = await response.json();
console.log(data);

Python

import requests

order_id = 984512

response = requests.put(
  f'https://b2b.allaria.dev/v1/broker/orders/edit/{order_id}',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json={ 'quantity': 100.0 }
)

data = response.json()
print(data)

Node.js

const axios = require('axios');

const orderId = 984512;

const response = await axios.put(
  `https://b2b.allaria.dev/v1/broker/orders/edit/${orderId}`,
  { quantity: 100.0 },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

2XX Éxito

{
  "status": "OK",
  "description": "Order edited successfully."
}