Como verificar quem detém um NFT: ERC-721 e ERC-1155

Para um token ERC-721 existente, consulte ownerOf(tokenId) no contrato correto da coleção para encontrar seu titular registrado atual. No ERC-1155, consulte balanceOf(account, id) para saber quantas unidades desse ID uma conta detém. São perguntas diferentes: as unidades de um tipo ERC-1155 podem estar em várias contas.

Comece pela rede, pelo endereço completo do contrato da coleção e pelo ID do token. Mantenha esses três identificadores juntos ao verificar um explorador ou leitor de contratos conhecido. Uma imagem igual, o nome da coleção ou o total de NFTs não basta para identificar uma posição específica.

Este guia verifica registros públicos de tokens. Ele não estabelece a identidade da pessoa por trás de um endereço, a autenticidade ou o preço de uma obra, nem seus direitos em um serviço de custódia. O procedimento não envolve transferência nem conexão de carteira.

Escolha a consulta de acordo com o padrão do token

A interface ERC-721 oferece tanto uma contagem por conta quanto uma consulta de token individual. No ERC-1155, a interface do padrão pede uma conta e um ID de tipo de token juntos.

Padrão e leitura	O que informar	O que o resultado significa
ERC-721 ownerOf(tokenId)	Um ID de token	Endereço do titular desse token existente
ERC-721 balanceOf(account)	Um endereço de conta	Quantos NFTs desse contrato a conta detém
ERC-1155 balanceOf(account, id)	Conta e ID de tipo de token	Quantas unidades desse ID a conta detém

Suponha que uma coleção ERC-721 hipotética tenha tokens com os IDs 42 e 43. A conta A detém 42; a conta B detém 43. As duas contagens são 1. Esses números não mostram qual conta detém 42; a consulta pelo ID específico mostra.

Agora considere outro contrato ERC-1155 hipotético. A conta A detém 3 unidades do ID 42 e a conta B detém 2. Ambos os saldos podem ser positivos no mesmo instante. Chamar A de única proprietária do ID 42 ignoraria as unidades de B. Os exemplos explicam as leituras; não são resultados de uma coleção real.

Identifique a coleção e o ID antes de confiar em uma correspondência

Um ID de token pertence a um contrato específico. O ID 42 de uma coleção não identifica o ID 42 de outra. As regras de identificação do ERC-721 descrevem o par contrato e ID em uma rede; não presuma que os IDs seguem uma sequência.

Encontre as informações oficiais de implantação da coleção por um caminho confiável, ou use o registro de uma transação conhecida, para confirmar a rede e o endereço completo do contrato. Um contrato imitador pode usar um nome e uma imagem familiares. Uma resposta aparentemente normal de uma função dessa cópia não faz dela a coleção pretendida.

Obtenha o ID nos detalhes do item em vez de adivinhar pelo nome. Preserve o valor exato. Se uma interface exibe um ID hexadecimal e outra um decimal, confirme que representam o mesmo inteiro antes de compará-los. O endereço do contrato identifica a coleção, enquanto o endereço da conta é o titular que você está verificando. O guia sobre endereço de carteira e contrato de token explica essa diferença.

Para um item inesperado, siga o guia de segurança sobre NFTs de spam antes de abrir qualquer link incluído na descrição. Você pode examinar os registros públicos por um caminho em que já confia, sem seguir um link para resgatar prêmios.

Faça uma consulta de leitura e guarde o resultado

As etapas abaixo descrevem como examinar registros públicos. Elas não foram testadas em uma carteira real para este artigo. A documentação primária desses métodos foi consultada em 24 de outubro de 2026.

1. Anote a identificação completa. Registre a rede, o contrato da coleção e o ID exato do token. Acrescente o endereço da conta se estiver verificando uma carteira específica.
2. Confirme o padrão e selecione o método público de leitura. Use os detalhes do contrato e a interface verificada do explorador confiável. Os nomes das opções variam. Para ERC-721, use ownerOf com o ID; para ERC-1155, use balanceOf com conta e ID. Uma interface ausente ou sem suporte exige investigação, não a suposição de que se trata do outro padrão.
3. Leia o estado atual e registre quando foi observado. Guarde o endereço ou a quantidade retornada e, quando disponível, o número do bloco. Compare chamadas no mesmo bloco, se possível: consultas separadas ao estado mais recente podem observar uma transferência entre as leituras.
4. Interprete a resposta no alcance correto. Compare o endereço completo retornado pelo ERC-721 com a conta pretendida. No ERC-1155, uma quantidade positiva confirma unidades registradas para aquela conta; uma resposta válida de zero indica que não havia unidades ali naquele estado. Nenhum dos resultados lista todos os outros titulares.
5. Marque leituras com falha ou indisponíveis como desconhecidas. Mantenha o erro ou a indicação de indisponibilidade no registro. Confira ID, contrato, rede e leitor antes de concluir que o token está ausente. Não transforme uma consulta com falha em saldo zero.

A referência ERC721 da OpenZeppelin exige um token existente para o método público ownerOf. Portanto, um ID inexistente ou queimado pode gerar uma falha em vez de retornar um titular útil. Essa falha, sozinha, não determina se você digitou o ID errado, selecionou outro contrato ou consultou um token inválido.

Não confunda essa função pública com uma função auxiliar interna cujo nome começa com sublinhado. Você está examinando a interface pública documentada. Essas leituras não precisam de assinatura, aprovação ou frase de recuperação. Se um site pedir alguma delas apenas para revelar o titular, interrompa esse procedimento.

Quando o titular registrado é um contrato

Um NFT pode estar em uma conta de contrato. O endereço retornado pode, portanto, pertencer a um cofre, um depósito em garantia, um mecanismo de staking ou outro serviço, em vez da sua carteira usada para assinar. Isso, por si só, não resolve quem tem os direitos econômicos nem se o item pode ser recuperado.

Se você depositou o NFT conscientemente em um serviço, confira os registros oficiais desse serviço e a transação de depósito conhecida. Relacione os direitos da sua conta à coleção e ao ID exatos. Não transfira nem retire ativos apenas para que a galeria da carteira mostre a imagem esperada.

Em uma posição de liquidez, verificar o titular só informa qual endereço detém o NFT. O guia do NFT de posição Uniswap v3 trata da tarefa separada de conferir os ativos e as taxas da posição subjacente. O endereço do titular do NFT, por si só, não fornece nenhum desses valores.

Termine com uma posição identificada, não com uma miniatura

A referência ERC1155 da OpenZeppelin descreve o resultado como unidades de um tipo específico detidas por uma conta. Guarde essa quantidade junto com a conta e o ID. Não a substitua por um rótulo de proprietário único ao estilo ERC-721 nem a divida usando uma escala decimal ERC-20 sem relação com o token.

Seu registro está completo quando contém rede, contrato, ID do token, padrão, titular retornado ou unidades por conta e bloco ou horário da observação. Acrescente uma nota de custódia quando o titular registrado for um contrato de serviço. Se um campo essencial continuar sem resposta, marque a posição como não verificada.

A galeria ajuda a explorar; esse registro responde à pergunta mais restrita sobre o que o contrato escolhido informa para o token exato. Ele não certifica a coleção, concede permissão de transferência, identifica uma pessoa nem calcula um valor de venda.