Skip to main content

​
Qu’est-ce que l’API DAS ?

L’API Digital Asset Standard (DAS) est une spécification open-source qui vous offre une interface unifiée pour chaque type d’actif numérique sur Solana :
  • NFTs réguliers (Non-Fungible Tokens)
  • NFTs compressés (cNFTs, utilisant la compression d’état)
  • Tokens fongibles (SPL Token et Token-2022, y compris les extensions)
Un ensemble unique de méthodes couvre les métadonnées, la propriété, les soldes, les collections, les créateurs, la recherche et les preuves de Merkle - vous permettant de créer des places de marché NFT, des portefeuilles, des suiveurs de portefeuilles, des applications à accès restreint par token, et des outils d’analyse avec la même API. Les deux réseaux partagent les mêmes méthodes :
  • Mainnet : https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Devnet : https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY

​
Pourquoi Helius pour l’API DAS ?

Tous les types d'actifs, une API

NFTs, NFTs compressés et tokens fongibles (SPL et Token-2022) via une seule interface.

Métadonnées complètes

Données on-chain et off-chain (Arweave, IPFS) indexées et retournées ensemble en un seul appel.

Données de prix incluses

Informations de prix en USD pour les tokens vérifiés, retournées avec les soldes.

Recherche et filtrage

Interrogation par propriétaire, collection, créateur, autorité ou filtres d’attributs riches.

​
Quelle méthode devrais-je utiliser ?

La plupart des intégrations commencent par l’une des trois méthodes. Utilisez ce tableau pour choisir le bon point d’entrée, puis cherchez les méthodes spécialisées ci-dessous. En règle générale :
  • Vous connaissez l’ID exact de l’actif ? Utilisez getAsset (ou getAssetBatch pour plusieurs).
  • Lister les éléments d’un portefeuille ? Utilisez getAssetsByOwner.
  • Filtrer par collection, type de token ou attributs ? Utilisez searchAssets.

​
Méthodes clés

​
Actif unique

getAsset

Données complètes pour un actif par son ID.

getAssetBatch

Jusqu’à 1 000 actifs en une seule requête.

​
Actifs par propriétaire, collection ou créateur

getAssetsByOwner

Tous les actifs détenus par un portefeuille, avec métadonnées et soldes.

getAssetsByGroup

Tous les actifs d’une collection (clé de groupe collection).

getAssetsByCreator

Tous les actifs frappés par un créateur spécifique.

getAssetsByAuthority

Tous les actifs contrôlés par une autorité donnée.

​
Recherche

searchAssets

Filtrage flexible par propriétaire, collection, tokenType, et attributs.

​
Actifs compressés et preuves

getAssetProof

Preuve Merkle pour un actif compressé, requise pour les opérations on-chain.

getAssetProofBatch

Preuves Merkle pour plusieurs actifs compressés à la fois.

getSignaturesForAsset

Historique des signatures de transactions pour un actif.

getNftEditions

Toutes les éditions imprimées à partir d’un NFT maître.

​
Comptes de tokens

getTokenAccounts

Comptes de tokens par mint ou propriétaire, avec soldes.

​
Commencer

Obtenir des actifs (NFTs)

Récupérez des NFTs et des objets de collection numériques : actif unique, par propriétaire, collections, preuves et éditions.

Obtenir des SPL Tokens

Interrogez les tokens fongibles : soldes, approvisionnement, détenteurs et comptes de tokens.

Rechercher des actifs

Filtrer les actifs par propriétaire, collection, type de token et attributs.

Pagination

Pagination par page et par jeu de clés pour les grands ensembles de résultats.

​
Travailler avec des types d’actifs spéciaux

​
Tokens fongibles

Helius étend l’API DAS pour couvrir tous les tokens, y compris les tokens SPL classiques (sans métadonnées) et le Token-2022 (plus leurs extensions). Le support des tokens fongibles est disponible via getAsset, getAssetsByOwner, et searchAssets en utilisant le paramètre tokenType, et les prix pour les tokens vérifiés sont retournés sous token_info.price_info. Pour les soldes, approvisionnement, détenteurs, et requêtes de comptes de tokens, voir le guide Obtenir des SPL Tokens et l’extension de tokens fongibles.

​
NFTs compressés

Les NFTs compressés par état (cNFTs) utilisent les mêmes méthodes que les NFTs réguliers pour les lectures (getAsset, getAssetsByOwner, searchAssets), plus deux méthodes spécifiques à la compression :
  • getAssetProof retourne la preuve Merkle requise pour vérifier et effectuer des opérations on-chain comme les transferts et les brûlures.
  • getSignaturesForAsset retourne l’historique des transactions pour un actif compressé.
Voir le guide Obtenir des actifs pour des exemples complets de NFTs compressés.

​
Données off-chain

La plupart des collections NFT stockent des métadonnées supplémentaires (attributs, images) off-chain sur Arweave ou IPFS. L’API DAS indexe ces données off-chain et les retourne avec les données on-chain en un seul appel.
Helius ne peut pas détecter les mutations des données off-chain. Les données off-chain ne sont rafraîchies qu’une fois que l’actif est revu on-chain (par exemple, lorsqu’il est modifié). Pour demander un ré-indexage, contactez le support Helius.

​
Meilleures pratiques

Pagination

Commencez à la page 1 (et non 0). Utilisez des limites de 100 à 1 000 et paginez pour les grands ensembles de données.

Gestion des erreurs

Vérifiez les erreurs à chaque réponse et réessayez avec un backoff exponentiel.

Performance

Utilisez des méthodes de lot lorsque c’est possible, mettez en cache les réponses, et évitez d’enchaîner les appels quand un seul suffit.

Sécurité

Ne jamais exposer votre clé API dans le code côté client. Proxy les requêtes via un serveur et définissez des politiques CORS.

​
Prochaines étapes

Obtenir des actifs (NFTs)

Récupérez et interrogez des NFTs et des objets de collection numériques.

Référence de l'API DAS

Schémas complets de requête et de réponse pour chaque méthode DAS.

FAQ sur l'API DAS

Questions courantes sur les actifs, les données de prix et l’utilisation.