> ## 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.
# searchAssets
> Pesquise e filtre NFTs Solana, NFTs comprimidos e tokens usando critérios flexíveis, incluindo propriedade, criadores, coleções e atributos customizados
## Parâmetros de Requisição
O endereço da carteira Solana para recuperar ativos digitais de propriedade para filtrar os resultados da pesquisa.
Filtrar por tipos específicos de tokens Solana, incluindo NFTs comprimidos (cNFTs), NFTs regulares,
NFTs programáveis (pNFTs), ou tokens SPL fungíveis para descoberta direcionada de ativos.
* `fungible`
* `nonFungible`
* `regularNft`
* `compressedNft`
* `all`
A página de resultados a ser retornada.
Os critérios de endereço de autoridade para filtrar ativos digitais Solana com base na autoridade do programa,
útil para encontrar ativos controlados por protocolos específicos ou autoridades de atualização.
O número máximo de ativos a serem retornados.
As opções de ordenação para a resposta.
Os critérios pelos quais os ativos serão ordenados.
* `created`
* `recent_action`
* `updated`
* `none`
A direção da ordenação.
* `asc`
* `desc`
Filtrar por NFTs Solana comprimidos (cNFTs) que utilizam tecnologia de compressão de estado
para custos de armazenamento reduzidos e melhor escalabilidade.
Filtrar por ativos Solana elegíveis para compressão, mas que ainda não foram
comprimidos no formato de compressão de estado.
Critérios de delegado para a pesquisa de ativos.
Critérios de endereço de criador para encontrar NFTs Solana criados por artistas específicos,
projetos, ou criadores para atribuição e rastreamento de royalties.
Se um criador é verificado.
Array de agrupamento de coleção para filtrar NFTs Solana por sua associação de coleção
(por exemplo, \["collection", "\"]) para encontrar ativos relacionados.
Endereço da árvore de Merkle para filtrar NFTs comprimidos (cNFTs) por sua árvore de coleção.
Este parâmetro é específico do Helius e não faz parte da especificação oficial do DAS.
Critérios de fornecimento para a pesquisa de ativos.
Critérios de cunhagem de fornecimento para a pesquisa de ativos.
Se um ativo está congelado.
Se um ativo está queimado.
Filtrar ativos que possuem uma Identidade de Agente (plugin externo MPL Core AgentIdentity).
Filtrar por endereço de cunhagem do token de agente base58 do programa de registro de agentes.
Filtrar por PDA de assinante de ativo base58 (MPL Core).
O tipo de interface padrão de token Solana para filtrar por implementações específicas de NFTs
incluindo NFTs programáveis, NFTs legados, tokens fungíveis, e ativos, coleções ou grupos MPL Core (MIP-11).
* `V1_NFT`
* `V1_PRINT`
* `LEGACY_NFT`
* `V2_NFT`
* `FungibleAsset`
* `FungibleToken`
* `Custom`
* `Identity`
* `Executable`
* `ProgrammableNFT`
* `MplCoreAsset`
* `MplBubblegumV2`
* `MplCoreCollection`
* `MplCoreGroup`
Critérios de tipo de alvo de royalties.
Critérios de alvo de royalties.
Critérios de valor de royalties.
Critérios de modelo de propriedade.
Um cursor para paginação para trás.
Um cursor para paginação para frente.
Opções avançadas de exibição para personalizar a resposta de pesquisa de ativos Solana.
Mostrar coleções não verificadas em vez de ignorá-las.
Mostrar metadados para a coleção.
Mostrar o número total de ativos correspondentes (requisição mais lenta).
Mostrar o saldo nativo (SOL) do proprietário.
Exibir ativos com saldo zero.
## OpenAPI
````yaml pt-BR/openapi/das-api/searchAssets.yaml POST /
openapi: 3.1.0
info:
title: Solana NFT Discovery & Search API
version: 1.0.0
description: >-
API avançada de Padrão de Ativo Digital Solana (DAS) para pesquisa e
descoberta de NFTs, tokens e outros ativos digitais em todo o ecossistema
Solana com poderosas capacidades de filtragem. Esta API de busca abrangente
fornece a base para marketplaces de NFTs, aplicativos de portfólio e
plataformas de análise para descobrir e filtrar ativos digitais com base em
múltiplos critérios, incluindo coleções, criadores, status de compactação e
propriedade - com suporte para NFTs tradicionais e compactados em todo o
ecossistema Solana.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint Mainnet RPC
- url: https://devnet.helius-rpc.com
description: Endpoint Devnet RPC
security: []
paths:
/:
post:
tags:
- RPC
summary: searchAssets
description: >-
Pesquise e descubra ativos digitais Solana com opções de filtragem
abrangentes. Esta poderosa API de descoberta permite que aplicativos
encontrem NFTs, NFTs compactados, tokens fungíveis e outros ativos
digitais usando múltiplos critérios, incluindo propriedade, criadores,
coleções, status de compactação e atributos de metadados. Perfeito para
marketplaces, rastreadores de portfólio e plataformas de análise que
necessitam de capacidades avançadas de descoberta de ativos em todo o
ecossistema Solana.
Capacidades principais:
- Busca por múltiplos critérios em todos os padrões de NFT Solana
(tradicional, compactado, programável)
- Filtragem baseada em coleções para projetos e comunidades de NFT
- Consultas baseadas em criadores e propriedade para análise de
atribuição e portfólio
- Filtragem por status de compactação para identificar ativos
custo-eficientes
- Pesquisa por atributos de metadados para descoberta baseada em
características
- Suporte completo à paginação para grandes conjuntos de resultados
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: A versão do protocolo JSON-RPC.
default: '2.0'
id:
type: string
description: Um ID para identificar a solicitação.
default: '1'
method:
type: string
enum:
- searchAssets
description: O nome do método JSON-RPC a ser invocado.
default: searchAssets
params:
type: object
description: Parâmetros para o método `searchAssets`.
default:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
page: 1
limit: 10
tokenType: all
required:
- ownerAddress
- tokenType
properties:
ownerAddress:
type: string
description: >-
O endereço da carteira Solana para recuperar ativos
digitais possuídos para filtragem de resultados de
busca.
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType:
type: string
enum:
- fungible
- nonFungible
- regularNft
- compressedNft
- all
description: >-
Filtro para tipos específicos de tokens Solana,
incluindo NFTs compactados (cNFTs), NFTs regulares, NFTs
programáveis (pNFTs) ou tokens fungíveis SPL para
descoberta direcionada de ativos.
example: all
page:
type: integer
description: A página de resultados a ser retornada.
example: 1
authorityAddress:
type: string
description: >-
Os critérios de endereço de autoridade para filtrar
ativos digitais Solana com base na autoridade do
programa, útil para encontrar ativos controlados por
protocolos específicos ou autoridades de atualização.
example: string
limit:
type: integer
description: O número máximo de ativos a ser retornado.
example: 100
sortBy:
type: object
description: As opções de ordenação para a resposta.
properties:
sortBy:
type: string
description: Os critérios pelos quais os ativos serão ordenados.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: A direção de ordenação.
enum:
- asc
- desc
compressed:
type: boolean
description: >-
Filtro para NFTs Solana compactados (cNFTs) que usam
tecnologia de compactação de estado para custos de
armazenamento reduzidos e maior escalabilidade.
example: true
compressible:
type: boolean
description: >-
Filtro para ativos Solana que são elegíveis para
compactação, mas ainda não foram compactados no formato
de compactação de estado.
example: false
delegate:
type: integer
description: Critérios de delegação para a busca de ativos.
creatorAddress:
type: string
description: >-
Critérios do endereço da carteira do criador para
encontrar NFTs Solana criados por artistas, projetos ou
criadores específicos para rastreamento de atribuição e
royalties.
example: string
creatorVerified:
type: boolean
description: Se um criador é verificado.
example: true
grouping:
type: array
items:
type: string
description: >-
Array de agrupamento de coleções para filtrar NFTs
Solana por sua afiliação de coleção (por exemplo,
["coleção", ""]) para encontrar ativos
relacionados.
example:
- collection
- DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x
tree:
type: string
description: >-
Endereço da árvore de Merkle para filtrar NFTs
compactados (cNFTs) por sua árvore de coleções. Este
parâmetro é específico do Helius e não faz parte da
especificação oficial DAS.
example: mwfDfWTYkyPYcZWPHCQyYMZKwg7SxDxWRAhGkBcNqqL
supply:
type: integer
description: Critérios de fornecimento para a busca de ativos.
example: 0
supplyMint:
type: string
description: >-
Critérios de fornecimento de mint para a busca de
ativos.
frozen:
type: boolean
description: Se um ativo está congelado.
example: false
burnt:
type: boolean
description: Se um ativo está queimado.
example: false
isAgent:
type: boolean
description: >-
Filtrar ativos que possuem uma Identidade de Agente
(plugin externo MPL Core AgentIdentity).
agentToken:
type: string
description: >-
Filtrar pelo endereço base58 do mint de token de agente
do programa Agent Registry.
assetSigner:
type: string
description: Filtrar pelo PDA base58 do asset-signer (MPL Core).
interface:
type: string
description: >-
O tipo de interface do padrão de token Solana para
filtrar implementações específicas de NFT, incluindo
NFTs programáveis, NFTs legados, tokens fungíveis e
ativos, coleções ou grupos MPL Core (MIP-11).
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: Custom
royaltyTargetType:
type: string
description: Critérios de tipo de alvo de royalties.
example: creators
royaltyTarget:
type: integer
description: Critérios de alvo de royalties.
example: 0
royaltyAmount:
type: integer
description: Critérios de valor de royalties.
example: 0
ownerType:
type: integer
description: Critérios de modelo de propriedade.
example: 1
before:
type: string
description: Um cursor para paginação para trás.
example: string
after:
type: string
description: Um cursor para paginação para frente.
example: string
options:
type: object
description: >-
Opções avançadas de exibição para personalizar a
resposta da busca de ativos Solana.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Mostrar coleções não verificadas em vez de
ignorá-las.
showCollectionMetadata:
type: boolean
default: false
description: Mostrar metadados da coleção.
showGrandTotal:
type: boolean
default: false
description: >-
Mostrar o número total de ativos que correspondem
(solicitação mais lenta).
showNativeBalance:
type: boolean
default: false
description: Mostrar o saldo nativo (SOL) do proprietário.
showZeroBalance:
type: boolean
default: false
description: Exibir ativos com saldo zero.
example:
jsonrpc: '2.0'
id: my-id
method: searchAssets
params:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType: all
limit: 50
responses:
'200':
description: Resposta bem-sucedida
content:
application/json:
schema:
type: object
properties:
assets:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Todos os dados até e incluindo este slot são
garantidos de terem sido indexados.
example: 365750752
total:
type: integer
description: >-
O número total de NFTs Solana e ativos digitais que
correspondem aos critérios de busca.
example: 80
limit:
type: integer
description: O número máximo de ativos solicitados.
example: 50
page:
type: integer
description: A página atual de resultados.
example: 1
items:
type: array
description: Uma matriz de ativos.
items:
type: object
properties:
interface:
type: string
description: >-
O tipo de implementação do padrão de token
Solana do ativo digital.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Se este ativo possui uma Identidade de Agente
(plugin externo MPL Core AgentIdentity). Omitido
quando falso.
agent_token:
type: string
description: >-
Token de agente codificado em base58 do programa
Agent Registry. Omitido quando não registrado.
asset_signer:
type: string
description: >-
PDA asset-signer codificado em base58 para MPL
Core. Omitido quando não aplicável.
plugins:
type: object
description: >-
Plugins MPL Core, incluindo a adesão opcional ao
MIP-11 `groups`.
additionalProperties: true
id:
type: string
description: >-
O identificador único do endereço de mint do
ativo digital Solana.
ownership:
type: object
description: >-
Detalhes de propriedade do ativo digital Solana
incluindo proprietário atual e modelo.
content:
type: object
description: >-
O conteúdo e os metadados do ativo digital
Solana incluindo URI, atributos e mídia.
example:
total: 80
limit: 50
page: 1
items:
- interface: V1_NFT
id: SomeNftMintKey12345
ownership:
owner: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
ownership_model: single
content:
json_uri: https://example.com/metadata/12345.json
nativeBalance:
type: object
description: >-
O saldo nativo SOL da conta de carteira Solana em lamports
e valor em USD.
properties:
lamports:
type: integer
description: O número de lamports na conta.
price_per_sol:
type: number
description: O preço atual do SOL.
total_price:
type: number
description: O valor total em SOL nesta conta.
'400':
description: >-
Solicitação inválida. O servidor não conseguiu entender a
solicitação devido à sintaxe inválida.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32602
message:
type: string
example: Parâmetros de solicitação inválidos.
id:
type: string
example: '1'
'401':
description: >-
Não autorizado. O cliente deve se autenticar para obter a resposta
solicitada.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32001
message:
type: string
example: >-
Falha na autenticação. Chave de API ausente ou
inválida.
id:
type: string
example: '1'
'403':
description: Proibido. O cliente não tem direitos de acesso ao conteúdo.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32003
message:
type: string
example: Você não tem permissão para acessar este recurso.
id:
type: string
example: '1'
'404':
description: >-
Não encontrado. O servidor não consegue encontrar o recurso
solicitado.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32004
message:
type: string
example: >-
Nenhum ativo encontrado que coincida com os critérios
de busca.
id:
type: string
example: '1'
'429':
description: >-
Muitas solicitações. O usuário enviou muitas solicitações em um
determinado período de tempo.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32029
message:
type: string
example: >-
Limite de taxa excedido. Por favor, tente novamente
mais tarde.
id:
type: string
example: '1'
'500':
description: >-
Erro Interno do Servidor. O servidor encontrou uma situação que não
sabe como lidar.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32000
message:
type: string
example: Ocorreu um erro inesperado no servidor.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave API Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````