> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Como Obter NFTs Solana: Ativos, Coleções e Provas
> Recupere e consulte NFTs Solana, NFTs comprimidos, edições e provas usando a Helius DAS API. Guia completo com exemplos de código e melhores práticas.
## Visão Geral
Este guia abrange a leitura de NFTs e colecionáveis digitais com a Helius Digital Asset Standard (DAS) API: buscar um único ativo, listar NFTs de uma carteira, consultar por coleção ou criador, trabalhar com NFTs comprimidos e provas de Merkle, listar edições e ler o histórico de transações.
Para tokens fungíveis — saldos, suprimento, detentores e preços — veja o [Guia de Obtenção de Tokens SPL](/docs/pt-BR/das/get-tokens). Os mesmos métodos `getAsset` e `getAssetsByOwner` servem tanto para NFTs quanto para tokens; esta página se concentra nos fluxos de trabalho de NFTs e colecionáveis.
## Quando usar isto
Use os métodos nesta página quando você estiver:
* Exibindo os metadados, imagem e atributos de um único NFT
* Listando todos os NFTs que uma carteira possui para um portfólio ou galeria
* Fornecendo um marketplace ou explorador com consultas de coleção e criador
* Verificando ou transferindo NFTs comprimidos (que requerem provas de Merkle)
* Mostrando o histórico de transações on-chain de um NFT
* Listando as edições impressas a partir de um NFT mestre
## Métodos de NFT
Comece com `getAsset` para um único NFT ou `getAssetsByOwner` para a coleção de uma carteira. Cada cartão se liga à sua referência completa da API.
Dados completos de um NFT por seu ID.
Todos os NFTs mantidos por uma carteira.
Filtrar por coleção, criador, atributos e mais — veja o Guia de Busca de Ativos.
Todos os ativos cunhados por um criador.
Todos os ativos em uma coleção.
Histórico de transações para um ativo.
Edições impressas de um NFT mestre.
Prova de Merkle para um NFT comprimido.
### Buscar um único NFT
Recupere metadados completos, dados de propriedade e coleção para um NFT por seu ID:
```typescript theme={"system"}
const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getAsset',
params: { id: 'F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk' },
}),
});
const { result } = await response.json();
console.log(result.content.metadata.name, result.ownership.owner);
```
### Mais consultas de NFT
```typescript theme={"system"}
const getNFTsByOwner = async (ownerAddress) => {
const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getAssetsByOwner',
params: { ownerAddress, page: 1, limit: 10 },
}),
});
const { result } = await response.json();
return result;
};
getNFTsByOwner('86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY');
```
```typescript theme={"system"}
const getAssetsByCreator = async (creatorAddress) => {
const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getAssetsByCreator',
params: { creatorAddress, page: 1, limit: 100 },
}),
});
const { result } = await response.json();
return result;
};
getAssetsByCreator('9uBX3ASjxWvNBAD1xjbVaKA74mWGZys3RGSF7DdeDD3F');
```
```typescript theme={"system"}
const getAssetsByCollection = async (collectionAddress) => {
const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getAssetsByGroup',
params: { groupKey: 'collection', groupValue: collectionAddress, page: 1, limit: 100 },
}),
});
const { result } = await response.json();
return result;
};
getAssetsByCollection('J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w');
```
```typescript theme={"system"}
const getNFTTransactionHistory = async (mintAddress) => {
const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getSignaturesForAsset',
params: { id: mintAddress, page: 1, limit: 100 },
}),
});
const { result } = await response.json();
return result;
};
getNFTTransactionHistory('FNt6A9Mfnqbwc1tY7uwAguKQ1JcpBrxmhczDgbdJy5AC');
```
## NFTs Comprimidos
NFTs comprimidos por estado (cNFTs) são **lidos** com os mesmos métodos que NFTs regulares — `getAsset`, `getAssetsByOwner`, e `searchAssets` os retornam. Duas coisas são específicas para a compressão:
* **Provas de Merkle** — operações on-chain, como transferências e queimas, requerem uma prova de `getAssetProof`.
* **Histórico** — use `getSignaturesForAsset` (mostrado acima) para o histórico de transações de um cNFT.
```typescript theme={"system"}
const getProof = async (id) => {
const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: '1',
method: 'getAssetProof',
params: { id },
}),
});
const { result } = await response.json();
return result; // { root, proof, node_index, leaf, tree_id }
};
getProof('Bu1DEKeawy7txbnCEJE4BU3BKLXaNAKCYcHR4XhndGss');
```
## Melhores práticas
* Use [paginaçao](/docs/pt-BR/das/pagination) para métodos que retornam conjuntos de resultados grandes.
* Lide com erros usando try/catch e replique falhas transitórias com backoff exponencial.
* Cacheie respostas quando apropriado para reduzir chamadas à API.
* Use `getAssetBatch` em vez de muitas chamadas individuais de `getAsset` quando você tiver múltiplos IDs.
## Próximas etapas
Saldos de tokens fungíveis, suprimento, detentores e preços.
Filtrar NFTs por coleção, criador e atributos.
Perguntas comuns sobre ativos, dados de preço e uso.