BotRadixBotRadixDocumentación

Órdenes y posiciones

Órdenes a mercado y limitadas, take profit y stop loss, cierres parciales, inversión y límites de tamaño.

Ver en Markdown

Tipos de orden#

TipoCómo se ejecuta
A mercadoDe inmediato, al precio del oráculo, si está dentro de tu deslizamiento máximo. Si no, se rechaza. Siempre es inmediata o se cancela
LimitadaSolo a tu precio o a uno mejor. Si puede ejecutarse al crearla, se ejecuta al instante; si no, queda en espera hasta que se alcanza el precio
StopSe convierte en una ejecución a mercado cuando se alcanza el precio de activación

Las opciones de vigencia son GTC (válida hasta cancelarla), IOC (inmediata o cancelada) y FOK (completa o nada). Las órdenes limitadas admiten post-only. No hay órdenes stop-limit ni trailing.

Deslizamiento#

Las órdenes a mercado requieren un deslizamiento máximo. El terminal usa la preferencia de deslizamiento guardada para abrir e invertir: un 8 % por defecto, ajustable hasta un 10 %. La API de inversión admite hasta un 20 % y usa un 1 % si se omite el valor. El deslizamiento limita el precio aceptado: un valor bajo protege tu precio, pero hace más probable el rechazo en mercados rápidos; no asegura la ejecución.

Límites de tamaño#

  • Tamaño mínimo de posición: 18 USDC en los mercados del catálogo de v2.2 (configuración de cada mercado; el mínimo técnico del código es 1 USDC).
  • Tamaño máximo: limitado por los tramos de apalancamiento y los límites de interés abierto del mercado (consulta Apalancamiento y margen).
  • Cada mercado define su incremento de precio y su paso de cantidad, que se leen de los contratos.

Límites por cuenta#

Para acotar el trabajo de valoración y cierre, cada wallet puede tener los siguientes máximos. Estos límites no garantizan una ejecución rápida:

LímiteValor
Mercados con posiciones cruzadas32
Posiciones abiertas128
Órdenes de entrada abiertas (limitadas y stop en espera)256 (valor de referencia de v2.2, ajustable entre 32 y 1.000)

Si llegas al límite de órdenes abiertas, las órdenes nuevas se rechazan hasta que alguna se ejecute o se cancele; las órdenes que ya existen no se ven afectadas.

Órdenes en espera#

Una orden limitada o stop en espera reserva su margen, su comisión de apertura y una fianza reembolsable de 0,025 USDC (valor de referencia de v2.2; el código la limita a 1 USDC) hasta que la orden termina, incluida su cancelación o invalidación. Las órdenes grandes en espera se ejecutan en tramos de hasta 100.000 USDC cada uno (valor de referencia de v2.2; las FOK no se recortan). Las órdenes en espera las ejecuta el keeper del protocolo; para ello hace falta un permiso de ejecución, que se concede una sola vez con una firma gratuita y tiene una pequeña comisión por ejecución (consulta Comisiones).

Posiciones#

Una posición se identifica por su mercado, su lado, su modo de margen y su apalancamiento. Puedes tener a la vez un long y un short en el mismo mercado (por ejemplo, con distinto apalancamiento o modo de margen); las órdenes con las mismas características se suman a la misma posición neta.

Al abrir no se acepta la opción de solo reducción.

Take profit y stop loss#

  • En un long, el take profit debe estar por encima del precio actual y el stop loss por debajo; al revés en un short.
  • Cuando se activan, cierran toda la posición a mercado.
  • Cuando fijas un take profit, el vault intenta reservar capacidad para su beneficio dentro del tope. Mientras un take profit respaldado siga válido, su posición queda excluida del desapalancamiento automático; el respaldo no es una garantía de cobro en todos los escenarios. La ventana de confirmación te indica si tu take profit está respaldado. Consulta Take profit respaldado y desapalancamiento automático.
  • Editar el TP/SL con tu clave de trading no pide firma a la wallet, y hasta 200 ediciones al día no pagan gas (valor de referencia de v2.2, ajustable entre 1 y 2.000).

Cerrar#

  • Cierra a mercado o con precio limitado, la parte de la posición que quieras (del 0,01 % al 100 %). El terminal ofrece atajos del 5, 10, 20, 50, 75 y 100 %.
  • Un cierre limitado es una orden de solo reducción que espera hasta ejecutarse; una por posición.
  • Si un cierre parcial dejara menos que el tamaño mínimo de posición del mercado (18 USDC en el catálogo de v2.2; se usa el mínimo vigente de su mercado), se cierra la posición entera. La ventana de confirmación te avisa antes de firmar.
  • Hoy cerrar no tiene comisión del protocolo. El código actual permite una comisión de cierre de hasta el 0,10 %; la confirmación muestra una estimación y una orden pendiente paga la comisión vigente al ejecutarse; el desapalancamiento automático, las salidas, las emergencias y las liquidaciones nunca la pagan. Tu resultado realizado, descontado el funding, se liquida en tu colateral.

Invertir#

Invertir cierra una posición (o una parte) y abre el lado contrario en un solo paso atómico, pagando la comisión de apertura (y la de servicio) de la parte abierta. Si ya tienes una posición del lado contrario con la misma clave (mercado, modo de margen y apalancamiento), la parte invertida se une a esa posición neta en lugar de abrir otra, y el tramo de apalancamiento se comprueba sobre el tamaño resultante; si no cabe, la inversión entera se rechaza. En ese caso la inversión devuelve el id de la posición neta existente: en la cadena no aparece un DexPositionOpened nuevo, sino un DexPositionChanged de esa neta. En los mercados con reglas de riesgo V2, la parte abierta se ejecuta comprometida con un precio observado después de tu orden, así que la inversión pasa por tu clave de trading (o por la ruta delegada de la API con un ejecutor del protocolo); sin ella, el terminal te pide activarla (INVERT_NEEDS_AGENT).

Margen aislado#

En una posición aislada puedes:

  • Añadir margen (botón "Margen +"), lo que aleja su precio de liquidación. Solo se puede usar USDC libre: si tus posiciones cruzadas necesitan ese USDC, la acción se rechaza con un mensaje claro.
  • Retirar margen, siempre que el margen que quede siga cubriendo tamaño ÷ apalancamiento más la pérdida no realizada de la posición y el funding que deba (los beneficios no cuentan). Necesita un precio de como mucho 10 segundos, y el DEX y ese mercado deben estar abiertos a riesgo nuevo.
  • Cambiar el apalancamiento. Al bajarlo se añade el margen necesario. Subirlo se permite hasta el máximo del tramo para el tamaño actual de la posición, y solo devuelve el margen sobrante con la misma regla que una retirada.

Tu clave de trading puede hacer todo esto sin ventana de la wallet; el protocolo paga el gas. El margen solo se mueve entre tu cuenta y tus propias posiciones aisladas, nunca fuera del DEX.

Con un mercado cruzado en sesión cerrada. Si un mercado de tu cuenta cruzada tiene la sesión cerrada (por ejemplo, un índice en fin de semana), tu saldo del DEX no se puede valorar y no sirve como margen aislado. Entonces el margen de una apertura aislada o de "Margen +" sale de tu wallet: el contrato trae el margen (en una apertura a mercado, más un 0,30 % del tamaño para las comisiones máximas; en una orden limitada o stop, más un 0,31 % del tamaño y la fianza de la orden, 0,025 USDC como valor de referencia de v2.2; lo que no se gaste queda como saldo del DEX) y lo usa en la misma transacción. Tu wallet firma esa operación concreta: la cofirma junto a tu clave de trading, o la firma ella misma si no usas clave de trading; una sesión de trading no puede hacerlo. Si lo envía BotRadix, además firmas un permiso de USDC por ese importe exacto (gratis, sin gas); el contrato solo trae ese importe y el permiso queda a cero. La ventana de confirmación te explica las firmas antes de abrirlas. Si tu wallet no tiene USDC suficiente, se rechaza (WALLET_MARGIN_BALANCE_REQUIRED); "Margen +" sin clave de trading, WALLET_MARGIN_NEEDS_AGENT. El dinero de tus posiciones cruzadas nunca se usa mientras no se pueda valorar, y cuando la sesión reabre vuelves a usar tu saldo del DEX.

Cancelar y reemplazar#

Las órdenes en espera pueden cancelarse o reemplazarse con tu clave de trading, sin firma de la wallet.

Última actualización: 2026-10-12