Swap y Pares de Trading

Requisitos previos de acceso

• Permiso (módulo): manageToken
• Licencia/Feature: MANAGE_TOKENS
• Contenedor del menú: TOKENIZACIÓN → grupo Tokenización → Gestionar Tokens (iconos Swap y Pares de trading en la fila / en la barra de acciones)

Qué es / cuándo usar

Esta pantalla cubre dos configuraciones distintas relacionadas con la negociación de tokens:

1. Swap automático — define con qué tokens un token determinado puede ser intercambiado directamente (swap rápido, sin aprobación manual). Solo está disponible para tokens con Swap automático (isAutomaticSwap) activado.
2. Pares de trading — define los pares de mercado de la exchange interna (book de ofertas): par base/cotización, tamaños mínimo/máximo de orden, precisión de precio/cantidad y tasa del par.

Requisitos previos

• Permiso: manageToken (doble — enum CPM + módulo en la BD).
• Licencia/Feature: MANAGE_TOKENS.
• Para Swap: el token y los tokens-par deben tener Swap automático (isAutomaticSwap = true). Los tokens sin esta bandera no aparecen como opción.
• Para Pares de trading: los tokens deben estar habilitados para compra y para la exchange (buyable, operate_exchange / integrate_book).

Configuración de Swap

1. En Gestionar Tokens, haz clic en el ícono Swap en la fila del token (solo se activa si el token tiene swap automático).
2. El modal lista los tokens disponibles (solo los que tienen swap automático) y los pares ya configurados.
3. Agrega tokens para formar pares de swap o elimina los existentes.
4. Haz clic en Guardar (createOrUpdateSwapPairs).

Campo	Qué es	Efecto en el sistema/backend
Token seleccionado	Token cuyos pares están siendo editados	TokensPairs.id
Pares (lista)	Tokens con los que el swap está permitido	pairs[] — cada ítem guarda el id, nombre e imagen del token-par

Configuración de Pares de Trading

Accesible mediante el botón Pares de trading (ruta /manage-tokens/trading-pairs, opcionalmente filtrada por tokenId). Lista los pares del token seleccionado, con acciones para crear, editar, activar/desactivar, definir como predeterminado y eliminar.

Campo (modal)	Qué es	Efecto en el sistema/backend
Token base	Token base del par	tokenId
Token de cotización	Token de cotización del par	pairTokenId
Habilitado	Activa/desactiva el par en el book	enabled
Predeterminado	Marca el par como el default del token	isDefault (vía setDefaultPair)
Orden de visualización	Posición del par en la lista	displayOrder
Símbolo en la exchange	Símbolo del par en el proveedor externo	exchangeSymbol
Tamaño mínimo / máximo de orden	Límites de volumen por orden	minimumOrderSize / maximumOrderSize
Precisión de precio / cantidad	Decimales aceptados	pricePrecision / quantityPrecision
Tasa del par (%)	Tasa aplicada en las operaciones del par	feePercentage

Acciones y modales

• Agregar/eliminar token en el swap: manipula la lista local; solo se persiste al guardar.
• Crear / Editar par: modal con los campos anteriores.
• Definir como predeterminado: setDefaultPair.
• Activar/Desactivar: updateTradingPair({ enabled }).
• Eliminar par: confirma y elimina (deleteTradingPair).

Reglas de negocio / consideraciones

Atención

• Swap y Pares de trading son mecanismos diferentes: el swap es un intercambio directo token↔token; los pares de trading alimentan el book de la exchange interna.
• Los tokens sin Swap automático no pueden formar pares de swap — activa la bandera en la edición del token primero.

• Ingreso de la casa (book): en el OrderBook, la liquidación del vendedor usa el precio límite de la orden (order.price), no el precio de ejecución. El delta entre el límite y el precio de ejecución es ingreso de la casa — tener en cuenta al analizar los números de órdenes y tasas de pares.
• Valores financieros: los tamaños de orden, la precisión y la tasa se manejan con precisión (BigNumber) — sin redondeo en la configuración.

Ejemplos

Escenario 1 — Habilitar swap entre una stablecoin y dos tokens

1. Asegúrate de que BSCUSDT, UST (Polygon) y BRZ tengan Swap automático activado.
2. Abre el Swap de BSCUSDT.
3. Agrega UST y BRZ a la lista de pares.
4. Guarda. Resultado: los usuarios pueden intercambiar BSCUSDT directamente por UST o BRZ.

Escenario 2 — Crear un par de mercado predeterminado en la exchange interna

1. Abre Pares de trading filtrando por el token base (ej.: AXIA).
2. Crear par: base AXIA, cotización USDT, minimumOrderSize = 0,0001, pricePrecision = 2, quantityPrecision = 4, feePercentage = 0,10.
3. Marca Predeterminado y Habilitado.
4. Guarda. Resultado: AXIA/USDT se convierte en el par predeterminado en el book, con la tasa y los límites definidos.

Pantallas relacionadas

• Gestionar Tokens
• Editar Tokens
• Informe Financiero del Token