Cómo comprobar quién tiene un NFT: ERC-721 y ERC-1155

Para un token ERC-721 existente, consulta ownerOf(tokenId) en el contrato correcto de la colección para conocer a su titular registrado actual. En ERC-1155, consulta balanceOf(account, id) para saber cuántas unidades de ese ID tiene una cuenta. Son preguntas distintas: las unidades de un tipo ERC-1155 pueden repartirse entre varias cuentas.

Empieza por la red, la dirección completa del contrato de la colección y el ID del token. Mantén juntos estos tres identificadores al consultar un explorador o lector de contratos conocido. Una imagen coincidente, el nombre de una colección o el número total de NFT no basta para identificar una tenencia concreta.

Esta guía comprueba registros públicos de tokens. No determina la identidad de la persona detrás de una dirección, la autenticidad o el precio de una obra ni tus derechos ante un servicio de custodia. El procedimiento no incluye transferencias ni conexiones de cartera.

Elige la consulta según el estándar del token

La interfaz ERC-721 ofrece tanto un recuento por cuenta como la consulta de un token individual. En ERC-1155, la interfaz del estándar solicita conjuntamente una cuenta y un ID de tipo de token.

Estándar y consulta	Qué introduces	Qué significa el resultado
ERC-721 ownerOf(tokenId)	Un ID de token	Dirección del titular de ese token existente
ERC-721 balanceOf(account)	Una dirección de cuenta	Cuántos NFT de ese contrato tiene
ERC-1155 balanceOf(account, id)	Cuenta e ID de tipo de token	Cuántas unidades de ese ID tiene

Supongamos que una colección ERC-721 hipotética tiene tokens con los ID 42 y 43. La cuenta A tiene 42; la cuenta B tiene 43. Los dos recuentos son 1. Esos números no permiten saber qué cuenta tiene 42; la consulta del ID concreto sí.

Consideremos ahora otro contrato ERC-1155 hipotético. La cuenta A tiene 3 unidades del ID 42 y la cuenta B tiene 2. Ambos saldos pueden ser positivos en el mismo instante. Llamar a A único propietario del ID 42 ignoraría las unidades de B. Estos ejemplos explican las consultas; no son resultados de una colección real.

Identifica la colección y el ID antes de confiar en una coincidencia

Un ID de token pertenece a un contrato determinado. El ID 42 de una colección no identifica al ID 42 de otra. Las reglas de identificación de ERC-721 describen la pareja contrato e ID dentro de una cadena; no des por hecho que los ID son consecutivos.

Busca los datos oficiales de despliegue de la colección por una vía fiable o usa el registro de una transacción conocida para confirmar la red y la dirección completa del contrato. Un contrato imitador puede utilizar un nombre y una imagen conocidos. Que esa copia responda a una función habitual no la convierte en la colección que buscas.

Obtén el ID de los detalles del objeto, sin adivinarlo por su nombre. Conserva el valor exacto. Si una interfaz muestra un ID hexadecimal y otra uno decimal, verifica que representan el mismo entero antes de compararlos. La dirección del contrato identifica la colección y la dirección de cuenta es el titular que estás comprobando. La guía sobre direcciones de cartera y contratos de token explica la diferencia.

Si el objeto apareció sin esperarlo, consulta la guía de seguridad sobre NFT de spam antes de abrir enlaces incluidos en su descripción. Puedes revisar los registros públicos por una vía que ya conoces sin seguir un enlace para reclamar premios.

Haz una consulta de solo lectura y guarda el resultado

Los pasos siguientes describen cómo revisar registros públicos. No se probaron con una cartera real para este artículo. La documentación primaria de estos métodos se consultó el 24 de octubre de 2026.

1. Anota la identidad completa. Guarda la red, el contrato de la colección y el ID exacto del token. Añade la dirección de cuenta si compruebas una cartera concreta.
2. Confirma el estándar y elige su método público de lectura. Usa los datos del contrato y la interfaz verificada del explorador de confianza. Las etiquetas varían. Para ERC-721 usa ownerOf con el ID; para ERC-1155 usa balanceOf con cuenta e ID. Una interfaz ausente o incompatible exige investigar, no suponer que se trata del otro estándar.
3. Lee el estado actual y registra cuándo lo observaste. Guarda la dirección o cantidad devuelta y, si está disponible, el número de bloque. Compara consultas en el mismo bloque cuando sea posible: dos lecturas del último estado pueden quedar separadas por una transferencia.
4. Interpreta la respuesta con el alcance correcto. Compara la dirección completa devuelta por ERC-721 con la cuenta que querías comprobar. En ERC-1155, una cantidad positiva confirma unidades registradas para esa cuenta, mientras que una respuesta válida de cero indica que no había unidades allí en ese estado. Ningún resultado enumera a todos los demás titulares.
5. Marca como desconocidas las lecturas fallidas o no disponibles. Conserva el error o la indicación de indisponibilidad. Revisa ID, contrato, red y lector antes de concluir que el token no existe. No conviertas una consulta fallida en saldo cero.

La referencia ERC721 de OpenZeppelin exige un token existente para el método público ownerOf. Por eso un ID inexistente o quemado puede provocar un error en lugar de devolver un titular útil. Ese error por sí solo no determina si escribiste mal el ID, elegiste otro contrato o consultaste un token inválido.

No confundas esta función pública con una función auxiliar interna cuyo nombre empieza por un guion bajo. Estás revisando la interfaz pública documentada. Estas lecturas no necesitan firma, aprobación ni frase de recuperación. Si un sitio te pide alguna de ellas solo para mostrar al titular, abandona ese procedimiento.

Cuando el titular registrado es un contrato

Un NFT puede estar en una cuenta de contrato. La dirección obtenida puede pertenecer a una bóveda, un depósito en garantía, un sistema de staking u otro servicio, en lugar de tu cartera de firma. Eso, por sí solo, no resuelve quién tiene los derechos económicos ni si el objeto se puede recuperar.

Si depositaste el NFT de forma consciente en un servicio, comprueba sus registros oficiales y la transacción de depósito conocida. Vincula los derechos de tu cuenta con la colección y el ID exactos. No transfieras ni retires activos solo para que la galería de la cartera muestre la imagen que esperabas.

En una posición de liquidez, comprobar al titular solo indica qué dirección tiene el NFT. La guía del NFT de posición de Uniswap v3 trata por separado la comprobación de los activos y comisiones de la posición subyacente. La dirección del titular del NFT, por sí sola, no proporciona ninguna de esas cantidades.

Termina con una tenencia identificada, no con una miniatura

La referencia ERC1155 de OpenZeppelin describe el resultado como unidades de un tipo concreto que tiene una cuenta. Guarda esa cantidad junto con la cuenta y el ID. No la sustituyas por una etiqueta de propietario único al estilo ERC-721 ni la dividas usando una escala decimal ERC-20 ajena.

El registro está completo cuando contiene red, contrato, ID del token, estándar, titular devuelto o unidades por cuenta y bloque o momento de observación. Añade una nota de custodia si el titular registrado es un contrato de servicio. Si queda algún campo esencial sin resolver, marca la tenencia como no verificada.

La galería sirve para explorar; este registro responde a una pregunta más concreta: qué informa el contrato elegido sobre ese token exacto. No certifica la colección, concede permiso para transferir, identifica a una persona ni calcula un precio de venta.