> ## 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.
# getAssetsByGroup
> Recupere todos os NFTs Solana e NFTs comprimidos em uma coleção ou grupo específico com chaves de agrupamento flexíveis e suporte a paginação
## Parâmetros da Solicitação
O tipo de classificação do grupo Solana para buscar (por exemplo, 'collection', 'community', 'creator', etc.).
O endereço da coleção Solana ou identificador do grupo para recuperar todos os NFTs correspondentes.
O número da página para paginação nos resultados da coleção Solana.
O número máximo de NFTs Solana a serem retornados por solicitação desta coleção.
As opções de ordenação para a resposta.
O critério pelo qual os NFTs Solana recuperados na coleção serão ordenados.
* `created`
* `recent_action`
* `updated`
* `none`
A direção pela qual os NFTs Solana recuperados na coleção serão ordenados.
* `asc`
* `desc`
O cursor para paginar para trás através dos ativos.
O cursor para paginar para frente através dos ativos.
As opções de exibição para a resposta.
Exibe informações de agrupamento para coleções não verificadas ao invés de ignorá-las.
Exibe os metadados da coleção.
Mostra o número total de ativos que correspondem à consulta. Isso tornará a solicitação mais lenta.
## OpenAPI
````yaml pt-BR/openapi/das-api/getAssetsByGroup.yaml POST /
openapi: 3.1.0
info:
title: Solana NFT Collection Explorer API
version: 1.0.0
description: >
API Avançada de Solana Digital Asset Standard (DAS) para explorar coleções
completas de NFT e grupos de tokens na blockchain Solana. Esta API
especializada de navegação de coleções permite que aplicativos recuperem
todos os ativos digitais dentro de coleções, comunidades ou agrupamentos
específicos com capacidades poderosas de filtragem e ordenação. Perfeita
para marketplaces de NFT, aplicativos de portfólio e plataformas de análise
que precisam exibir coleções completas com formatação consistente em NFTs
tradicionais e comprimidos.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAssetsByGroup
description: >
Recupere todos os ativos digitais Solana pertencentes a uma coleção ou
agrupamento específico. Esta poderosa API de navegação de coleções
retorna uma lista completa de NFTs que compartilham a mesma designação
de grupo (como coleção, comunidade ou outro agrupamento), com metadados
abrangentes e detalhes de propriedade para cada ativo. Essencial para
marketplaces de NFT exibindo coleções, aplicativos de portfólio
mostrando ativos agrupados e plataformas de análise que rastreiam
métricas de coleção em todo o ecossistema Solana.
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:
- getAssetsByGroup
description: O nome do método DAS a ser invocado.
default: getAssetsByGroup
params:
type: object
default:
groupKey: collection
groupValue: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
properties:
groupKey:
type: string
description: >-
O tipo de classificação de grupo Solana para buscar (por
exemplo, 'collection', 'community', 'creator', etc.).
example: collection
groupValue:
type: string
description: >-
O endereço da coleção Solana ou identificador de grupo
para recuperar todos os NFTs correspondentes.
example: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
page:
type: integer
description: >-
O número da página para paginação dos resultados da
coleção Solana.
example: 1
limit:
type: integer
description: >-
O número máximo de NFTs Solana a retornar por
solicitação desta coleção.
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 NFTs Solana recuperados
na coleção serão ordenados.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: >-
A direção pela qual os NFTs Solana recuperados na
coleção serão ordenados.
enum:
- asc
- desc
before:
type: string
description: O cursor para paginar para trás pelos ativos.
example: string
after:
type: string
description: O cursor para paginar para frente pelos ativos.
example: string
options:
type: object
description: As opções de exibição para a resposta.
properties:
showUnverifiedCollections:
type: boolean
description: >-
Exibe informações de agrupamento para coleções não
verificadas em vez de ignorá-las.
default: false
showCollectionMetadata:
type: boolean
description: Exibe metadados para a coleção.
default: false
showGrandTotal:
type: boolean
description: >-
Mostra o número total de ativos que corresponderam à
consulta. Isso tornará a solicitação mais lenta.
default: false
required:
- groupKey
- groupValue
responses:
'200':
description: Resposta bem-sucedida
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Todos os dados até e incluindo este slot são
garantidos como indexados.
example: 365750752
total:
type: integer
description: >-
O número total de NFTs Solana encontrados nesta
coleção ou grupo.
example: 1
limit:
type: integer
description: O número máximo de ativos solicitados.
example: 1
page:
type: integer
description: A página atual de resultados.
example: 1
items:
type: array
description: >-
Um array de NFTs Solana pertencentes a esta coleção ou
grupo.
items:
type: object
properties:
interface:
type: string
description: >-
A interface de padrão de token Solana do NFT
nesta coleção.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: ProgrammableNFT
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 de assinatura de ativos codificado em Base58
para MPL Core. Omitido quando não aplicável.
plugins:
type: object
description: >-
Plugins MPL Core, incluindo a adesão opcional a
`groups` do MIP-11.
additionalProperties: true
id:
type: string
description: >-
O endereço de mint único deste NFT Solana na
coleção.
example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
authorities:
type: array
description: >-
As autoridades de atualização para este NFT
Solana na coleção.
compression:
type: object
description: >-
O status de compressão deste NFT Solana,
indicando se ele usa tecnologia de compressão de
estado.
grouping:
type: array
description: >-
As associações de coleção e agrupamento para
este NFT Solana.
royalty:
type: object
description: >-
A configuração de royalties para este NFT Solana
quando vendido em marketplaces.
creators:
type: array
description: >-
Os endereços de criadores verificados associados
a este NFT Solana na coleção.
ownership:
type: object
description: >-
Os detalhes de propriedade atuais para este NFT
Solana na coleção.
supply:
type: object
description: >-
As informações de fornecimento para este NFT
Solana se for uma edição master com impressões.
mutable:
type: boolean
description: >-
Se os metadados deste NFT Solana podem ser
atualizados pela autoridade.
example: true
burnt:
type: boolean
description: Se este NFT Solana foi queimado/destruído.
example: false
'400':
description: >-
Requisiçã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 para o grupo especificado.
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 de API Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````