> ## 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
> Récupère tous les NFTs Solana et NFTs compressés dans une collection ou un groupe spécifique avec des clés de groupement flexibles et un support de pagination
## Paramètres de la requête
Le type de classification du groupe Solana à rechercher (par exemple, 'collection', 'communauté', 'créateur', etc.).
L'adresse de la collection Solana ou l'identifiant de groupe pour récupérer tous les NFTs correspondants.
Le numéro de page pour paginer à travers les résultats de la collection Solana.
Le nombre maximum de NFTs Solana à retourner par requête depuis cette collection.
Les options de tri pour la réponse.
Les critères par lesquels les NFTs Solana récupérés dans la collection seront triés.
* `created`
* `recent_action`
* `updated`
* `none`
La direction par laquelle les NFTs Solana récupérés dans la collection seront triés.
* `asc`
* `desc`
Le curseur pour paginer en arrière à travers les actifs.
Le curseur pour paginer en avant à travers les actifs.
Les options d'affichage pour la réponse.
Affiche les informations de regroupement pour les collections non vérifiées au lieu de les ignorer.
Affiche les métadonnées de la collection.
Affiche le nombre total d'actifs qui ont correspondu à la requête. Cela ralentira la requête.
## OpenAPI
````yaml fr/openapi/das-api/getAssetsByGroup.yaml POST /
openapi: 3.1.0
info:
title: Solana NFT Collection Explorer API
version: 1.0.0
description: >
API DAS (Digital Asset Standard) avancée de Solana pour explorer des
collections NFT complètes et des groupes de jetons sur la blockchain Solana.
Cette API spécialisée de navigation des collections permet aux applications
de récupérer tous les actifs numériques au sein de collections, communautés
ou groupements spécifiques avec des capacités de filtrage et de tri
puissantes. Parfaite pour les places de marché NFT, les applications de
portefeuille et les plateformes d'analyse qui doivent afficher des
collections complètes avec un formatage cohérent pour les NFT traditionnels
et compressés.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Point d'accès RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Point d'accès RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAssetsByGroup
description: >
Récupérez tous les actifs numériques Solana appartenant à une collection
ou un groupement spécifique. Cette API puissante de navigation des
collections renvoie une liste complète des NFT partageant la même
désignation de groupe (telle que collection, communauté ou autre
groupement), avec des métadonnées complètes et des détails de propriété
pour chaque actif. Essentiel pour les places de marché NFT affichant des
collections, les applications de portefeuille montrant des actifs
groupés et les plateformes d'analyse suivant les métriques à l'échelle
de la collection dans l'écosystème Solana.
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La version du protocole JSON-RPC.
default: '2.0'
id:
type: string
description: Un ID pour identifier la requête.
default: '1'
method:
type: string
enum:
- getAssetsByGroup
description: Le nom de la méthode DAS à invoquer.
default: getAssetsByGroup
params:
type: object
default:
groupKey: collection
groupValue: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
properties:
groupKey:
type: string
description: >-
Le type de classification de groupe Solana à rechercher
(par ex., 'collection', 'communauté', 'créateur', etc.).
example: collection
groupValue:
type: string
description: >-
L'adresse de la collection Solana ou l'identifiant de
groupe pour récupérer tous les NFT correspondants.
example: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
page:
type: integer
description: >-
Le numéro de page pour la pagination à travers les
résultats de la collection Solana.
example: 1
limit:
type: integer
description: >-
Le nombre maximum de NFT Solana à renvoyer par requête à
partir de cette collection.
example: 100
sortBy:
type: object
description: Les options de tri pour la réponse.
properties:
sortBy:
type: string
description: >-
Les critères selon lesquels les NFT Solana récupérés
dans la collection seront triés.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: >-
La direction selon laquelle les NFT Solana récupérés
dans la collection seront triés.
enum:
- asc
- desc
before:
type: string
description: Le curseur pour paginer en arrière à travers les actifs.
example: string
after:
type: string
description: Le curseur pour paginer en avant à travers les actifs.
example: string
options:
type: object
description: Les options d'affichage pour la réponse.
properties:
showUnverifiedCollections:
type: boolean
description: >-
Affiche les informations de groupement pour des
collections non vérifiées au lieu de les ignorer.
default: false
showCollectionMetadata:
type: boolean
description: Affiche les métadonnées de la collection.
default: false
showGrandTotal:
type: boolean
description: >-
Affiche le nombre total d'actifs qui correspond à la
requête. Cela ralentira la requête.
default: false
required:
- groupKey
- groupValue
responses:
'200':
description: Réponse réussie
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Toutes les données jusqu'à ce créneau inclusif sont
garanties d'avoir été indexées.
example: 365750752
total:
type: integer
description: >-
Le nombre total de NFT Solana trouvés dans cette
collection ou groupement.
example: 1
limit:
type: integer
description: Le nombre maximum d'actifs demandés.
example: 1
page:
type: integer
description: La page actuelle des résultats.
example: 1
items:
type: array
description: >-
Un tableau de NFT Solana appartenant à cette
collection ou groupement.
items:
type: object
properties:
interface:
type: string
description: >-
L'interface standard du jeton Solana du NFT dans
cette collection.
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: >-
Indique si cet actif a une Identité Agent
(plugin externe MPL Core AgentIdentity).
Omission lorsque faux.
agent_token:
type: string
description: >-
Jeton d'agent encodé en Base58 à partir du
programme de Registre des Agents. Omission
lorsque non enregistré.
asset_signer:
type: string
description: >-
Signature d'actif encodée en Base58 pour MPL
Core. Omission lorsque non applicable.
plugins:
type: object
description: >-
Plugins MPL Core, y compris l'adhésion
optionnelle aux `groups` MIP-11.
additionalProperties: true
id:
type: string
description: >-
L'adresse unique de frappe de ce NFT Solana dans
la collection.
example: JEGruwYE13mhX2wi2MGrPmeLiVyZtbBptmVy9vG3pXRC
authorities:
type: array
description: >-
Les autorités de mise à jour pour ce NFT Solana
dans la collection.
compression:
type: object
description: >-
Le statut de compression de ce NFT Solana,
indiquant s'il utilise la technologie de
compression d'état.
grouping:
type: array
description: >-
Les associations de collection et de groupement
pour ce NFT Solana.
royalty:
type: object
description: >-
La configuration de la redevance pour ce NFT
Solana lorsqu'il est vendu sur des places de
marché.
creators:
type: array
description: >-
Les adresses créatrices vérifiées associées à ce
NFT Solana dans la collection.
ownership:
type: object
description: >-
Les détails de propriété actuels pour ce NFT
Solana dans la collection.
supply:
type: object
description: >-
Les informations sur l'offre pour ce NFT Solana
s'il s'agit d'une édition principale avec
impressions.
mutable:
type: boolean
description: >-
Indique si les métadonnées de ce NFT Solana
peuvent être mises à jour par l'autorité.
example: true
burnt:
type: boolean
description: Indique si ce NFT Solana a été brûlé/détruit.
example: false
'400':
description: >-
Demande incorrecte. Le serveur n'a pas pu comprendre la demande en
raison d'une syntaxe invalide.
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: Paramètres de la requête non valides.
id:
type: string
example: '1'
'401':
description: >-
Non autorisé. Le client doit s'authentifier pour obtenir la réponse
demandée.
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: >-
Échec de l'authentification. Clé API manquante ou
invalide.
id:
type: string
example: '1'
'403':
description: Interdit. Le client n'a pas les droits d'accès au contenu.
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: >-
Vous n'avez pas la permission d'accéder à cette
ressource.
id:
type: string
example: '1'
'404':
description: Non trouvé. Le serveur ne peut pas trouver la ressource demandée.
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: Aucun actif trouvé pour le groupe spécifié.
id:
type: string
example: '1'
'429':
description: >-
Trop de requêtes. L'utilisateur a envoyé trop de requêtes dans un
laps de temps donné.
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 fréquence dépassée. Veuillez réessayer plus
tard.
id:
type: string
example: '1'
'500':
description: >-
Erreur interne du serveur. Le serveur a rencontré une situation
qu'il ne sait pas gérer.
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: Une erreur inattendue est survenue sur le serveur.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Votre clé API Helius. Vous pouvez en obtenir une gratuitement sur le
[tableau de bord](https://dashboard.helius.dev/api-keys).
````