> ## 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
> Recherchez et filtrez les NFTs Solana, les NFTs compressés, et les tokens en utilisant des critères flexibles incluant la propriété, les créateurs, les collections et les attributs personnalisés
## Paramètres de la requête
L'adresse du portefeuille Solana pour récupérer les actifs numériques possédés afin de filtrer les résultats de recherche.
Filtrez par type spécifique de token Solana incluant les NFTs compressés (cNFTs), les NFTs réguliers, les NFTs programmables (pNFTs) ou les tokens SPL fongibles pour une découverte ciblée d'actifs.
* `fungible`
* `nonFungible`
* `regularNft`
* `compressedNft`
* `all`
La page des résultats à retourner.
Critère d'adresse d'autorité pour filtrer les actifs numériques Solana en fonction de l'autorité du programme, utile pour trouver des actifs contrôlés par des protocoles spécifiques ou des autorités de mise à jour.
Le nombre maximum d'actifs à retourner.
Options de tri pour la réponse.
Les critères selon lesquels les actifs seront triés.
* `created`
* `recent_action`
* `updated`
* `none`
La direction du tri.
* `asc`
* `desc`
Filtrez les NFTs Solana compressés (cNFTs) qui utilisent la technologie de compression d'état pour réduire les coûts de stockage et améliorer l'évolutivité.
Filtrez les actifs Solana éligibles pour la compression mais qui n'ont pas encore été compressés au format de compression d'état.
Critère de délégation pour la recherche d'actifs.
Critères d'adresse de portefeuille du créateur pour trouver des NFTs Solana créés par des artistes, projets ou créateurs spécifiques pour l'attribution et le suivi des royalties.
Si un créateur est vérifié.
Tableau de groupements de collection pour filtrer les NFTs Solana par leur appartenance à une collection (par ex. \["collection", "\"]) pour trouver des actifs associés.
Adresse de l'arbre de Merkle pour filtrer les NFTs compressés (cNFTs) par leur arbre de collection. Ce paramètre est spécifique à Helius et ne fait pas partie de la spécification officielle DAS.
Critères de l'offre pour la recherche d'actifs.
Critères de frappe de l'offre pour la recherche d'actifs.
Si un actif est gelé.
Si un actif est brûlé.
Filtrez les actifs qui ont une identité d'agent (plugin externe AgentIdentity MPL Core).
Filtrez par adresse de frappe de token agent en base58 provenant du programme Agent Registry.
Filtrez par signataire d'actif en base58 PDA (MPL Core).
Le type d'interface standard de token Solana pour filtrer des implémentations spécifiques de NFT incluant les NFTs programmables, les NFTs hérités, les tokens fongibles et les actifs, collections ou groupes MPL Core (MIP-11).
* `V1_NFT`
* `V1_PRINT`
* `LEGACY_NFT`
* `V2_NFT`
* `FungibleAsset`
* `FungibleToken`
* `Custom`
* `Identity`
* `Executable`
* `ProgrammableNFT`
* `MplCoreAsset`
* `MplBubblegumV2`
* `MplCoreCollection`
* `MplCoreGroup`
Critère du type de cible de royalty.
Critère de la cible de royalty.
Critère du montant de la royalty.
Critères de modèle de propriété.
Un curseur pour la pagination vers l'arrière.
Un curseur pour la pagination vers l'avant.
Options d'affichage avancées pour personnaliser la réponse de recherche d'actifs Solana.
Affichez les collections non vérifiées au lieu de les ignorer.
Affichez les métadonnées de la collection.
Affichez le nombre total d'actifs correspondants (requête plus lente).
Affichez le solde natif (SOL) du propriétaire.
Affichez les actifs avec un solde nul.
## OpenAPI
````yaml fr/openapi/das-api/searchAssets.yaml POST /
openapi: 3.1.0
info:
title: Solana NFT Discovery & Search API
version: 1.0.0
description: >
API avancée Standard de l'Actif Numérique (DAS) pour rechercher et découvrir
des NFT, des tokens et d'autres actifs numériques dans l'écosystème Solana
avec des capacités de filtrage puissantes.
Cette API de recherche complète fournit la base pour les places de marché
NFT, les applications de portefeuille et les plateformes d'analyse
pour découvrir et filtrer les actifs numériques selon plusieurs critères, y
compris les collections, les créateurs, le statut de compression
et la propriété - avec un support pour les NFT traditionnels et compressés
dans l'ensemble de l'écosystème 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 RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: searchAssets
description: >
Recherchez et découvrez des actifs numériques Solana avec des options de
filtrage complètes.
Cette API de découverte puissante permet aux applications de trouver des
NFT, des NFT compressés, des tokens fongibles,
et d'autres actifs numériques à l'aide de plusieurs critères, y compris
la propriété, les créateurs, les collections,
le statut de compression et les attributs de métadonnées. Parfait pour
les places de marché, les suiveurs de portefeuille
et les plateformes d'analyse nécessitant des capacités avancées de
découverte d'actifs
à travers l'écosystème Solana.
Capacités clés:
- Recherche multicritère sur tous les standards NFT Solana
(traditionnel, compressé, programmable)
- Filtrage basé sur les collections pour les projets et communautés NFT
- Requêtes basées sur le créateur et la propriété pour l'attribution et
l'analyse de portefeuille
- Filtrage de statut de compression pour identifier les actifs rentables
- Recherche d'attributs de métadonnées pour la découverte basée sur les
traits
- Support complet de la pagination pour les ensembles de résultats
volumineux
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 identifiant pour identifier la demande.
default: '1'
method:
type: string
enum:
- searchAssets
description: Le nom de la méthode JSON-RPC à invoquer.
default: searchAssets
params:
type: object
description: Paramètres pour la méthode `searchAssets`.
default:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
page: 1
limit: 10
tokenType: all
required:
- ownerAddress
- tokenType
properties:
ownerAddress:
type: string
description: >-
L'adresse du portefeuille Solana pour récupérer les
actifs numériques possédés afin de filtrer les résultats
de recherche.
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType:
type: string
enum:
- fungible
- nonFungible
- regularNft
- compressedNft
- all
description: >
Filtrer pour des types spécifiques de tokens Solana, y
compris les NFT compressés (cNFTs), les NFT réguliers,
les NFT programmables (pNFTs), ou les tokens SPL
fongibles pour une découverte d'actifs ciblée.
example: all
page:
type: integer
description: La page des résultats à retourner.
example: 1
authorityAddress:
type: string
description: >
Les critères d'adresse d'autorité pour filtrer les
actifs numériques Solana basé sur l'autorité de
programme,
utiles pour trouver des actifs contrôlés par des
protocoles spécifiques ou des autorités de mise à jour.
example: string
limit:
type: integer
description: Le nombre maximum d'actifs à retourner.
example: 100
sortBy:
type: object
description: Les options de tri pour la réponse.
properties:
sortBy:
type: string
description: Le critère par lequel les actifs seront triés.
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: Le sens du tri.
enum:
- asc
- desc
compressed:
type: boolean
description: >
Filtrer les NFT Solana compressés (cNFTs) qui utilisent
la technologie de compression d'état
pour des coûts de stockage réduits et une évolutivité
améliorée.
example: true
compressible:
type: boolean
description: >
Filtrer les actifs Solana éligibles à la compression
mais qui n'ont pas encore
été compressés dans le format de compression d'état.
example: false
delegate:
type: integer
description: Critères de délégué pour la recherche d'actifs.
creatorAddress:
type: string
description: >
Critères d'adresse de portefeuille du créateur pour
trouver des NFT Solana créés par des artistes,
projets ou créateurs spécifiques pour le suivi des
attributions et des royalties.
example: string
creatorVerified:
type: boolean
description: Si un créateur est vérifié.
example: true
grouping:
type: array
items:
type: string
description: >
Tableau de regroupement par collection pour filtrer les
NFT Solana par leur appartenance à la collection
(par ex. ["collection", ""]) pour trouver
des actifs associés.
example:
- collection
- DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x
tree:
type: string
description: >
Adresse de l'arbre de Merkle pour filtrer les NFT
compressés (cNFTs) par leur arbre de collection.
Ce paramètre est spécifique à Helius et ne fait pas
partie de la spécification DAS officielle.
example: mwfDfWTYkyPYcZWPHCQyYMZKwg7SxDxWRAhGkBcNqqL
supply:
type: integer
description: Critères d'offre pour la recherche d'actifs.
example: 0
supplyMint:
type: string
description: Critères de frappe d'offre pour la recherche d'actifs.
frozen:
type: boolean
description: Si un actif est gelé.
example: false
burnt:
type: boolean
description: Si un actif est brûlé.
example: false
isAgent:
type: boolean
description: >-
Filtrer les actifs ayant une identité d'Agent (plugin
externe AgentIdentity de MPL Core).
agentToken:
type: string
description: >-
Filtrer par adresse de frappe de token agent en base58 à
partir du programme Agent Registry.
assetSigner:
type: string
description: Filtrer par PDA signé d'actif en base58 (MPL Core).
interface:
type: string
description: >
Le type d'interface standard du token Solana pour
filtrer des implémentations spécifiques de NFT
y compris les NFT programmables, les NFT hérités, les
tokens fongibles, et les actifs, collections ou groupes
MPL Core (MIP-11).
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplCoreCollection
- MplCoreGroup
- MplCoreGroup
example: Custom
royaltyTargetType:
type: string
description: Critères de type de cible de royalties.
example: creators
royaltyTarget:
type: integer
description: Critères de cible de royalties.
example: 0
royaltyAmount:
type: integer
description: Critères de montant de royalties.
example: 0
ownerType:
type: integer
description: Critères du modèle de propriété.
example: 1
before:
type: string
description: Un curseur pour paginer en arrière.
example: string
after:
type: string
description: Un curseur pour paginer en avant.
example: string
options:
type: object
description: >-
Options d'affichage avancées pour personnaliser la
réponse de recherche d'actifs Solana.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Afficher les collections non vérifiées au lieu de
les ignorer.
showCollectionMetadata:
type: boolean
default: false
description: Afficher les métadonnées pour la collection.
showGrandTotal:
type: boolean
default: false
description: >-
Afficher le nombre total d'actifs correspondants
(requête plus lente).
showNativeBalance:
type: boolean
default: false
description: Afficher le solde natif (SOL) du propriétaire.
showZeroBalance:
type: boolean
default: false
description: Afficher les actifs avec un solde nul.
example:
jsonrpc: '2.0'
id: my-id
method: searchAssets
params:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType: all
limit: 50
responses:
'200':
description: Réponse réussie
content:
application/json:
schema:
type: object
properties:
assets:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Toutes les données jusqu'à et y compris ce slot sont
garanties d'avoir été indexées.
example: 365750752
total:
type: integer
description: >-
Le nombre total de NFTs Solana et d'actifs numériques
correspondant aux critères de recherche.
example: 80
limit:
type: integer
description: Le nombre maximum d'actifs demandé.
example: 50
page:
type: integer
description: La page des résultats actuelle.
example: 1
items:
type: array
description: Un tableau d'actifs.
items:
type: object
properties:
interface:
type: string
description: >-
Le type d'implémentation du standard du token
Solana de l'actif numérique.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Si cet actif a une identité d'Agent (plugin
externe AgentIdentity de MPL Core). Omis quand
c'est faux.
agent_token:
type: string
description: >-
Token agent encodé en base58 depuis le programme
Agent Registry. Omis si non enregistré.
asset_signer:
type: string
description: >-
PDA signé d'actif encodé en base58 pour MPL
Core. Omis si 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'identifiant unique de l'adresse de frappe de
l'actif numérique Solana.
ownership:
type: object
description: >-
Détails de propriété de l'actif numérique
Solana, y compris le propriétaire actuel et le
modèle.
content:
type: object
description: >-
Le contenu et les métadonnées de l'actif
numérique Solana, y compris l'URI, les attributs
et les médias.
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: >-
Le solde SOL natif du compte de portefeuille Solana en
lamports et en valeur USD.
properties:
lamports:
type: integer
description: Le nombre de lamports sur le compte.
price_per_sol:
type: number
description: Le prix actuel de SOL.
total_price:
type: number
description: La valeur totale de SOL dans ce compte.
'400':
description: >-
Mauvaise Requête. 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 requête invalides.
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 le droit d'accéder 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é correspondant aux critères de
recherche.
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 taux 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 s'est produite 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).
````