Owlio
ES
← Blog
Guía paso a pasoPrincipiante

Tokens LP de Uniswap v2: activos del pool detrás de tu saldo

La cantidad de tokens LP no es la cantidad de ninguno de los activos subyacentes. Usa la emisión y las reservas del par para describir una posición en sus unidades.

Un saldo de tokens LP de Uniswap v2 describe una parte de un pool concreto, no una cantidad de ninguno de los dos tokens que contiene. Para una instantánea contable de solo lectura, divide tu saldo LP por la emisión total de LP del par y aplica esa fracción a cada reserva registrada. Asocia cada reserva a la dirección de su token y a su escala decimal.

Esto permite describir una posición existente. No es un importe de retiro garantizado, un cálculo de beneficios ni una instrucción para retirar liquidez. Una fila de la cartera etiquetada UNI-V2 es solo un punto de partida: muchos pares diferentes utilizan esa etiqueta.

Encuentra el par antes de interpretar su saldo LP

La explicación de los pools v2 de Uniswap describe los tokens de liquidez emitidos para los proveedores. La implementación oficial del token LP utiliza el mismo nombre y símbolo en distintos pares. Por eso, un símbolo por sí solo no identifica los activos que representa una tenencia.

Empieza por la red y la dirección completa del contrato del par, obtenidas de una transacción de liquidez conocida o de la interfaz del protocolo en la que ya confías. Confirma la fábrica mediante la lista oficial de despliegues v2 y comprueba que los tokens previstos corresponden al par de esa fábrica. Un nombre copiado o un contrato que expone métodos conocidos no demuestra que sea un despliegue oficial.

En esta implementación v2, el contrato del par también es el contrato del token LP. Lee las direcciones de token0() y token1() antes de utilizar las cifras de reservas. reserve0 corresponde a token0; reserve1 corresponde a token1. No asignes las dos cantidades según el orden de los símbolos en otra pantalla.

Limita este procedimiento a pares ordinarios de Uniswap v2. Una bifurcación, una bóveda gestionada o una posición concentrada pueden utilizar otra contabilidad. Un NFT de posición de Uniswap v3 necesita su propio registro de posición en lugar de este cálculo basado en la emisión de LP.

Reúne un conjunto coherente de cantidades

Para una posición LP mantenida directamente, recoge estas lecturas de los contratos verificados del par y de los tokens:

Lectura o campo Significado Unidad que conservar
balanceOf(account) del par Tokens LP de esta cuenta Unidades LP
totalSupply() del par Todos los tokens LP emitidos Las mismas unidades LP
getReserves() del par Reservas registradas de cada lado Enteros brutos de tokens
token0() y token1() del par Direcciones de los dos activos Direcciones completas
Decimales de cada token Escala de su cantidad de reserva bruta Su propia escala

Prioriza un bloque común para todas las lecturas. Si la herramienta solo ofrece llamadas separadas al último estado, guarda sus horas y marca la comparación como posiblemente incoherente. Una operación, un depósito o un retiro entre llamadas puede cambiar los datos de entrada.

El saldo LP y la emisión total deben usar la misma escala. Para la fracción, es válido dividir dos enteros LP brutos o dos cantidades LP correctamente formateadas. No es válido mezclar un entero bruto con una cifra formateada. Para las reservas, utiliza los decimales de cada token subyacente por separado; la guía de decimales de tokens explica esa conversión. Los metadatos desconocidos deben quedar sin resolver, sin suponer 18 por defecto.

No restes los tokens LP bloqueados o inaccesibles de la emisión total indicada para aumentar tu porcentaje. Este cálculo utiliza la emisión del contrato, no una estimación de la oferta circulante. Si la emisión es cero o falla una lectura esencial, detén el cálculo y registra el dato que falta.

Recorre una instantánea con unidades identificadas

Considera un par hipotético cuyas cifras ya están expresadas en unidades legibles. Tiene 500 tokens LP emitidos y tu cuenta mantiene directamente 5 tokens LP. Las reservas registradas son 80 unidades del token A y 24000 unidades del token B. Son cantidades inventadas, no un pool en vivo ni una cotización de precios.

La fracción LP es 5 / 500 = 0.01, es decir, 1%. Al aplicarla a las reservas registradas, resulta:

  • Token A: 80 * 0.01 = 0.8 unidades.
  • Token B: 24000 * 0.01 = 240 unidades.

El registro resultante es una posición LP con un equivalente basado en reservas de 0,8 A y 240 B en esa instantánea. No son 5 A más 5 B, y las cantidades de reserva no son precios en dólares. No es necesario suponer que B sea una stablecoin.

No sumes el valor mostrado del token LP y el valor de esas mismas cantidades subyacentes como dos tenencias separadas. Los tokens mantenidos de forma independiente fuera del pool constituyen otro saldo. Si un panel ya desglosa el token LP en sus activos subyacentes, determina qué incluye antes de añadir nada manualmente.

Esto también es distinto de medir el rendimiento. Tu parte actual de las reservas no indica las cantidades depositadas originalmente, los movimientos posteriores, los costes ni cuánto valdría simplemente mantener los activos iniciales. La comparación entre pérdida impermanente y mantener aborda esa otra cuestión.

Entiende por qué esto no promete un importe de reembolso

La implementación del par registra las reservas por separado de sus saldos reales de tokens. Su cálculo de quema utiliza los saldos y puede acuñar tokens LP de comisiones del protocolo antes de seleccionar la emisión total. La división entera también redondea los importes calculados. Por eso, una fracción de reservas registradas anteriormente no debe presentarse como la cantidad exacta que entregará una transacción de retirada de liquidez.

La transacción puede producirse en un estado distinto del observado. Las reglas de transferencia específicas de cada token también pueden afectar a las cantidades recibidas. Si decides realizar una transacción por separado, utiliza la estimación actual de retirada y las condiciones del protocolo; no envíes tokens LP directamente al par ni llames a su función de quema de bajo nivel como parte de esta inspección.

Las cantidades de reserva ya reflejan el estado registrado del pool. Añadirles una estimación extra de ingresos por comisiones puede contabilizar el valor dos veces. Esta guía no calcula un pago de comisiones, rendimiento futuro ni una tasa actual de comisiones del protocolo.

La custodia crea otro límite. Si los tokens LP se colocaron en staking o se depositaron en una bóveda, el balanceOf directo de tu cartera puede ser cero mientras el servicio registra un derecho a tu favor. Inspecciona el depósito conocido y la contabilidad del servicio. No asignes a tu cuenta todo el saldo LP del servicio ni reutilices el cálculo sencillo de cartera para un token de recibo de bóveda sin sus reglas de conversión.

Guarda un registro que puedas comprobar otra vez

Estos pasos se basan en la documentación pública y el código fuente examinados el 28 de octubre de 2026. No se probaron con una cartera o un pool en vivo para este artículo.

  1. Verifica la posición. Registra la red, el par, la fábrica, la cuenta y las direcciones de ambos tokens subyacentes mediante registros fiables del protocolo.
  2. Determina dónde están los tokens LP. Distingue la propiedad directa de la cartera de los registros de staking, bóvedas u otras formas de custodia.
  3. Recoge una instantánea coherente. Guarda el saldo LP, la emisión de LP, ambas reservas, su correspondencia con los tokens y las escalas decimales, junto con un bloque o las horas de observación.
  4. Calcula solo cuando los datos sean utilizables. Divide unidades LP equivalentes y aplica después la fracción por separado a ambas reservas. Conserva suficiente precisión; no redondees la fracción a cero antes de multiplicar.
  5. Etiqueta el resultado y concilia una vez. Márcalo como una estimación contable basada en reservas, conserva las notas de custodia y datos ausentes y comprueba si otra fila de la cartera ya representa la misma posición.

Estas lecturas públicas no requieren una firma de la cartera, una autorización de gasto ni una frase de recuperación. Una petición de mover fondos queda fuera de este procedimiento. Tienes un resultado útil cuando puedes explicar qué par mantienes, qué representan sus cantidades de reserva y por qué la instantánea difiere de una cotización de retiro. Deja los campos sin resolver como desconocidos en vez de convertir una carencia de visualización en un saldo preciso.

Preguntas frecuentes

¿1 token LP significa 1 token de cada lado del pool?

No. El token LP representa una participación proporcional en un par concreto. Su cantidad debe compararse con la emisión total de LP y las cantidades de reserva de ese par en la misma instantánea.

¿Dividir mi saldo LP por la emisión total da una cotización exacta de retiro?

No. Es una fracción puntual para la contabilidad. La quema real usa los saldos de tokens y puede actualizar la emisión al acuñar LP para las comisiones del protocolo. Los cambios de estado, el redondeo entero y el comportamiento de los tokens también pueden afectar a lo que recibe el destinatario.

¿Un saldo LP de cero en mi cartera demuestra que no tengo una posición?

No. Puedes haber depositado tokens LP en un contrato de staking o de custodia. Comprueba los registros de ese servicio y tu depósito conocido antes de determinar qué derecho tienes. Una consulta de saldo fallida significa desconocido, no cero.