Comisiones de AMM v4

La comisión de intercambio del 0,25%, su división entre LP y protocolo, generación de PnL a partir de ejecuciones de OpenBook, y cómo el administrador retira las comisiones de protocolo acumuladas.

Esta página fue traducida automáticamente por IA. La versión en inglés es la fuente autorizada.

Ver versión en inglés →

​

El único nivel publicado

A diferencia de CPMM y CLMM, AMM v4 no tiene una cuenta AmmConfig. Las comisiones se almacenan directamente en la estructura AmmInfo.fees de cada pool y se fijan en la creación del pool. Los valores predeterminados que cubren esencialmente todos los pools de AMM v4 activos:

Campo en cadena	Predeterminado	Significado
swap_fee_numerator / swap_fee_denominator	25 / 10_000	Comisión bruta de intercambio en swaps por ruta AMM: 0,25% del volumen de entrada.
trade_fee_numerator / trade_fee_denominator	25 / 10_000	Vestigial después de la eliminación de OpenBook (históricamente se usaba para fijación de precios de órdenes limitadas). El mismo 0,25% que swap_fee por defecto.
pnl_numerator / pnl_denominator	12 / 100	Participación del protocolo en la comisión de intercambio: 12% — es decir, 0,25% × 12% = 0,03% del volumen. Se acumula en los contadores need_take_pnl_*.
min_separate_numerator / min_separate_denominator	5 / 10_000	Piso de precisión interna utilizado por la lógica de redondeo de división de comisiones.

Ten en cuenta que pnl_numerator / pnl_denominator es una fracción de la comisión de intercambio, no del volumen de operaciones — una lectura errónea común. La participación de LP es el complemento (88% de la comisión = 0,22% del volumen) y es implícita; no hay un numerador separado de “participación de LP”.

Un pequeño número de pools antiguos se crearon con numeradores diferentes; siempre lee AmmInfo.fees antes de citar.

No hay comisión de fondo ni línea de comisión de creador: estas son invenciones de CPMM/CLMM que no existían en el modelo de comisiones original de AMM v4.

​

Cómo se calcula la división

En cada intercambio, el pool cobra la comisión bruta de intercambio del monto de entrada y luego distribuye:

gross_fee   = ceil(amount_in * swap_fee_numerator / swap_fee_denominator)        // 0.25% of amount_in
pnl_portion = gross_fee * pnl_numerator / pnl_denominator                        // 12% of gross_fee
lp_portion  = gross_fee − pnl_portion                                            // 88% of gross_fee

• lp_portion se deja en la bóveda y contribuye al siguiente k. Los LP la capturan canjeando tokens de LP más tarde.
• pnl_portion incrementa AmmInfo.state_data.need_take_pnl_coin o need_take_pnl_pc dependiendo de cuál sea el lado de entrada del intercambio.

El mismo truco de preservación de invariantes que CPMM: la cantidad de PnL se encuentra físicamente en la bóveda pero se resta de las reservas utilizadas en la curva, por lo que TakePnl mueve tokens sin cambiar el precio.

​

PnL de OpenBook (histórico)

Eliminado. La integración de OpenBook ha sido eliminada del programa, por lo que el segundo flujo de PnL descrito en esta sección ya no se genera. Los contadores total_pnl_{coin,pc} ahora son campos deprecados — contienen valores históricos congelados y nunca se actualizan. La ruta de comisión de protocolo del 0,03% (arriba) no se ve afectada y sigue activa.

Históricamente, AMM v4 tenía un segundo flujo de ingresos similar a una comisión: cuando sus órdenes limitadas en OpenBook se ejecutaban, el pool podía estar en el lado tomador de la ejecución y ganar o pagar el diferencial de creador/tomador del mercado. Estos eventos de PnL se liquidaban en las bóvedas del pool durante MonitorStep y el programa los acreditaba a state_data.total_pnl_{coin,pc} como contadores informativos.

• Cuando la cuadrícula publicada del pool estaba correctamente calibrada alrededor del precio de la curva, las ejecuciones de OpenBook tendían a ser positivas en comisiones para el pool — el AMM estaba efectivamente creando mercado en OpenBook y ganando reembolsos de creador.
• Cuando OpenBook se pausaba o la cola de eventos se llenaba, el pool podía quedarse con órdenes antiguas que se ejecutaban a precios desfavorables, produciendo PnL negativo. Este acoplamiento operativo fue una de las motivaciones para alejarse del diseño híbrido.

Este PnL de OpenBook no era lo mismo que la comisión de protocolo del 0,03%. El PnL de OpenBook inflaba las reservas del pool directamente (beneficiando a los LP + protocolo proporcionalmente a la división de comisiones), mientras que la comisión de protocolo del 0,03% estaba etiquetada específicamente para retiro administrativo. Con el lado de OpenBook desactivado, el único acúmulo de comisiones hoy es el 0,25% en swaps de AMM y su división 22/3.

​

Recopilación

El administrador (multisig de Raydium) llama a WithdrawPnl para retirar need_take_pnl_* a las cuentas “propietario de PnL” a nivel de pool configuradas en el AmmConfig del programa (una configuración diferente, con alcance de programa — no el AmmConfig de estilo CPMM por pool). El retiro:

1. Transfiere need_take_pnl_coin / need_take_pnl_pc desde las bóvedas del pool al destino de PnL.
2. Pone a cero los contadores.

Ya no hay un paso de liquidación de OpenBook. Si el saldo de la bóveda es insuficiente para cubrir el PnL acumulado, la instrucción ahora devuelve TakePnlError directamente. La operación no mueve la curva — los LP no deberían ver ningún cambio de precio en una llamada a WithdrawPnl. Ten en cuenta que el diseño de cuenta de WithdrawPnl cambió en la actualización de 2026-07 (ver instrucciones).

​

Redención de comisiones de LP

No hay una instrucción dedicada para “recopilar comisiones de LP”. Las comisiones de LP se acumulan en las bóvedas e inflan k con el tiempo; los LP las realizan quemando tokens de LP a través de Withdraw. El valor de un token de LP crece monótonamente a medida que (coin_reserve_effective, pc_reserve_effective) crecen.

​

Visualización: dónde va 1.000 USDC de volumen

En un intercambio pesado en USDC de $1.000 contra un pool con parámetros predeterminados:

Comisión bruta de intercambio (0,25%):   $2,50
  Participación de LP   (0,22%):       $2,20   → permanece en el pool, aumenta k
  Participación de PnL  (0,03%):       $0,30   → need_take_pnl_pc, retirado por TakePnl
Resto enviado al usuario:   $997,50   (menos impacto de precio impulsado por la curva)

Compara con CPMM AmmConfig[0] (nivel 0,25%, sin comisión de creador): LP obtiene $2,10, protocolo $0,30, fondo $0,10. CPMM introduce la línea de fondo tallándola de lo que habría sido la participación de LP en el nivel equivalente de AMM v4.

​

Tabla de comparación

	AMM v4	CPMM index=0	CLMM index=2
Comisión de intercambio	0,25%	0,25%	0,25%
LP	0,22%	0,21%	Varía según emisiones
Protocolo	0,03%	0,03%	Por nivel
Fondo	N/A	0,01%	Por nivel
Creador (opcional)	N/A	0 por defecto	N/A
Dónde se sientan las comisiones	Bóveda del pool + need_take_pnl_*	Bóveda del pool + protocol_fees_* + fund_fees_*	Global + por tick + por posición

Matriz completa en reference/fee-comparison.

​

Notas para integradores

• Cotización. Obtén AmmInfo a través del SDK o api-v3.raydium.io/pools/info/ids. Las reservas ahora son solo de bóveda, por lo que puedes cotizar directamente contra los saldos de la bóveda — solo recuerda restar need_take_pnl_* (el PnL acumulado se mantiene en la bóveda pero se excluye de la curva).
• Parámetros de comisión obsoletos. En principio SetParams podría cambiar swap_fee_numerator, pero en la práctica el multisig de Raydium no ha cambiado los valores predeterminados para ningún pool activo. Aún así, siempre lee del estado en cadena en lugar de codificar valores.
• Sin recompensas. AMM v4 no admite emisiones de recompensas en el pool. Las granjas del ecosistema heredado (Farm v3 / v5 / v6) son el equivalente de la capa de apuesta — ver products/farm-staking.

​

Dónde ir a continuación

• products/amm-v4/math — la derivación de la comisión de intercambio dentro de la curva.
• products/amm-v4/instructions — listas de cuentas de WithdrawPnl / SetParams.
• reference/fee-comparison — matriz lado a lado.

Fuentes:

• Programa Raydium AMM — raydium-io/raydium-amm
• Campos de numerador/denominador de comisión de AMM v4 en cadena (verificados contra cuentas AmmInfo en mainnet).