Crear nueva orden

Coloca una orden y la devuelve tal como la almacenó el motor de trading. Las órdenes de incremento (market, limit, stop_market, stop_limit) abren o amplían una posición; las órdenes de cierre (stop, take, trailing_stop) se vinculan a una posición existente mediante positionId.

amount se lee en una unidad diferente por cada uno de los dos: en una orden de aumento es un importe de cotización reservado del saldo libre, en una orden de cierre es el tamaño del activo base de la posición a cerrar, sin reservar nada. El resto de los campos de tamaño (expectedAmount, sizeMode, baseSize, leverage) pertenecen solo a las órdenes de aumento.

Más allá del esquema a nivel de campo, la solicitud se verifica para:

• Forma para el tipo. Cada rechazo aquí es un 400 cuyo código nombra la combinación de campos en falta:
  • tamaño — amount_not_positive, base_size_required, base_size_negative, base_size_not_allowed;
  • apalancamiento — leverage_required, leverage_negative;
  • precio de activación — trigger_price_required, trigger_price_negative;
  • stop-loss / take-profit adjuntos a una orden de incremento — stop_trigger_price_negative, take_trigger_price_negative, stop_trigger_price_gt_trigger_price, stop_trigger_price_lt_trigger_price, take_trigger_price_gt_trigger_price, take_trigger_price_lt_trigger_price;
  • precio de stop-limit — stop_limit_price_required, stop_limit_price_negative, stop_limit_price_gt_trigger_price, stop_limit_price_lt_trigger_price;
  • stop móvil — trailing_stop_activation_price_negative, trailing_stop_offset_required, trailing_stop_offset_conflict, trailing_stop_offset_negative, trailing_stop_offset_percent_negative, trailing_stop_offset_percent_gte_one;
  • órdenes de cierre — position_id_required.
• Apalancamiento de una orden de incremento. Debe mantenerse dentro de los límites del mercado: no por debajo del mínimo del mercado ni por encima del máximo de la fase, con invalid_leverage (leverage más minLeverage o maxLeverage en el cuerpo).
• Cuenta. Debe pertenecer al llamador y estar en un estado de trading; las órdenes de incremento se rechazan además mientras la cuenta está bloqueada por el límite de capital gestionado, y necesitan amount disponible como saldo libre.
• Mercado. Debe estar abierto y dentro de la categoría en la que la cuenta puede operar (cripto o RWA). Un mercado de solo cierre no acepta nada más que una orden take creada sin un precio de activación.
• Posición, cuando se proporciona positionId: debe existir (position_not_found), estar abierta, estar en la misma cuenta, pertenecer al mismo mercado y tener la misma dirección que la orden (position_not_available).
• Precio de activación, contra el precio de mercado actual y — para stop / take — contra el precio de liquidación de la posición (trigger_price_gt_current, trigger_price_lt_current, trigger_price_gt_liquidation, trigger_price_lt_liquidation). Una orden market con un stop-loss / take-profit adjunto se comprueba contra el precio de liquidación que tendría su posición después de la ejecución: market_price_unavailable cuando no hay un precio actual contra el que comprobar, order_validation_invariant cuando faltan los campos de tamaño necesarios para esa proyección.
• Nocional de una orden de aumento. (amount − fee) × leverage debe ajustarse al nocional abierto máximo que el mercado permite en esa dirección (order_exceeds_max_open_notional).

Una orden diferida no se ejecuta aquí, por lo que aún puede fallar cuando su disparador se active más tarde: entonces termina con el estado canceled_by_error y un errorCode (insufficient_reserve_at_execution, order_below_min_notional, order_exceeds_market_depth, order_exceeds_max_open_notional, order_zero_size_at_execution, slippage_tolerance, market_close_only_at_execution), y se libera su reserva.

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