Skip to main content

Was ist die DAS API?

Die Digital Asset Standard (DAS) API ist eine Open-Source-Spezifikation, die Ihnen ein einheitliches Interface für jeden Typ von digitalem Asset auf Solana bietet:
  • Reguläre NFTs (Non-Fungible Tokens)
  • Komprimierte NFTs (cNFTs, unter Verwendung von State-Kompression)
  • Fungible Tokens (SPL Token und Token-2022, einschließlich Erweiterungen)
Ein einziger Satz von Methoden umfasst Metadaten, Besitzverhältnisse, Salden, Sammlungen, Ersteller, Suche und Merkle-Beweise - so können Sie NFT-Marktplätze, Wallets, Portfoliotracker, token-gesteuerte Apps und Analysetools gegen die gleiche API entwickeln. Beide Netzwerke teilen die gleichen Methoden:
  • Mainnet: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Devnet: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY

Warum Helius für die DAS API?

Alle Asset-Typen, eine API

NFTs, komprimierte NFTs und fungible Tokens (SPL und Token-2022) über ein einziges Interface.

Vollständige Metadaten

On-Chain- und Off-Chain-Daten (Arweave, IPFS), die zusammen in einem Aufruf indiziert und zurückgegeben werden.

Preisdaten enthalten

USD-Preisinformationen für verifizierte Tokens, zusammen mit Salden zurückgegeben.

Suche und Filterung

Abfrage nach Besitzer, Sammlung, Ersteller, Autorität oder umfangreichen Attributfiltern.

Welche Methode sollte ich verwenden?

Die meisten Integrationen beginnen mit einer von drei Methoden. Verwenden Sie diese Tabelle, um den richtigen Einstiegspunkt zu wählen, und greifen Sie dann auf die unten aufgeführten spezialisierten Methoden zurück. Als Faustregel gilt:
  • Kennen Sie die genaue Asset-ID? Verwenden Sie getAsset (oder getAssetBatch für viele).
  • Listen Sie die Bestände einer Wallet auf? Verwenden Sie getAssetsByOwner.
  • Filtern nach Sammlung, Token-Typ oder Attributen? Verwenden Sie searchAssets.

Wichtige Methoden

Einzelnes Asset

getAsset

Vollständige Daten für ein Asset anhand seiner ID.

getAssetBatch

Bis zu 1.000 Assets in einer einzigen Anfrage.

Assets nach Besitzer, Sammlung oder Ersteller

getAssetsByOwner

Alle von einer Wallet gehaltenen Assets mit Metadaten und Salden.

getAssetsByGroup

Alle Assets in einer Sammlung (Gruppenschlüssel collection).

getAssetsByCreator

Alle von einem bestimmten Ersteller geprägten Assets.

getAssetsByAuthority

Alle von einer bestimmten Autorität kontrollierten Assets.

Suche

searchAssets

Flexible Filterung nach Besitzer, Sammlung, tokenType und Attributen.

Komprimierte Assets und Beweise

getAssetProof

Merkle-Beweis für ein komprimiertes Asset, erforderlich für On-Chain-Operationen.

getAssetProofBatch

Merkle-Beweise für mehrere komprimierte Assets auf einmal.

getSignaturesForAsset

Transaktionssignaturverlauf für ein Asset.

getNftEditions

Alle Editionen, die von einem Master-NFT gedruckt wurden.

Token-Konten

getTokenAccounts

Token-Konten nach Mint oder Besitzer mit Salden.

Erste Schritte

Get Assets (NFTs)

NFTs und digitale Sammelobjekte abrufen: einzelnes Asset, nach Besitzer, Sammlungen, Beweise und Editionen.

Get SPL Tokens

Fungible Tokens abfragen: Salden, Angebot, Inhaber und Token-Konten.

Search Assets

Assets nach Besitzer, Sammlung, Token-Typ und Attributen filtern.

Pagination

Seitenbasierte und Keyset-Paginierung für große Ergebnismengen.

Arbeiten mit speziellen Asset-Typen

Fungible Tokens

Helius erweitert die DAS API, um alle Tokens abzudecken, einschließlich einfacher SPL Tokens (ohne Metadaten) und Token-2022 (plus deren Erweiterungen). Unterstützung für Fungible Tokens ist über getAsset, getAssetsByOwner und searchAssets mit dem tokenType Parameter verfügbar, und Preise für verifizierte Tokens werden unter token_info.price_info zurückgegeben. Für Salden-, Angebots-, Inhaber- und Token-Kontoabfragen siehe den Get SPL Tokens Leitfaden und die fungible Token Erweiterung.

Komprimierte NFTs

State-komprimierte NFTs (cNFTs) verwenden die gleichen Methoden wie reguläre NFTs für Lesezugriffe (getAsset, getAssetsByOwner, searchAssets), plus zwei kompressionsspezifische Methoden:
  • getAssetProof gibt den Merkle-Beweis zurück, der zur Verifizierung und Durchführung von On-Chain-Operationen wie Übertragungen und Brennen erforderlich ist.
  • getSignaturesForAsset gibt den Transaktionsverlauf für ein komprimiertes Asset zurück.
Siehe den Get Assets Leitfaden für vollständige komprimierte-NFT-Beispiele.

Off-Chain-Daten

Die meisten NFT-Sammlungen speichern zusätzliche Metadaten (Attribute, Bilder) außerhalb der Chain auf Arweave oder IPFS. Die DAS API indiziert diese Off-Chain-Daten und gibt sie zusammen mit On-Chain-Daten in einem einzigen Aufruf zurück.
Helius kann keine Off-Chain-Datenmutationen erkennen. Off-Chain-Daten werden nur dann aktualisiert, wenn das Asset erneut On-Chain gesehen wird (zum Beispiel, wenn es modifiziert wird). Um eine erneute Indizierung anzufordern, wenden Sie sich an den Helius-Support.

Beste Praktiken

Pagination

Beginnen Sie auf Seite 1 (nicht 0). Verwenden Sie Limits von 100–1.000 und paginieren Sie für große Datensätze.

Fehlerbehandlung

Überprüfen Sie bei jeder Antwort auf Fehler und versuchen Sie es mit exponentieller Rückoff-Methode erneut.

Leistung

Verwenden Sie nach Möglichkeit Batch-Methoden, cachen Sie Antworten und vermeiden Sie das Verkettung von Aufrufen, wenn einer ausreicht.

Sicherheit

Legen Sie Ihren API-Schlüssel niemals in klientseitigem Code offen. Leiten Sie Anfragen über einen Server weiter und setzen Sie CORS-Richtlinien fest.

Nächste Schritte

Get Assets (NFTs)

Abrufen und Abfragen von NFTs und digitalen Sammlerstücken.

DAS API Referenz

Vollständige Anfragen- und Antwortschemata für jede DAS-Methode.

DAS API FAQ

Häufige Fragen zu Assets, Preisdaten und Verwendung.