Zum Hauptinhalt springen

​
Was ist die DAS API?

Die Digital Asset Standard (DAS) API ist eine Open-Source-Spezifikation. Sie bietet dir eine einheitliche Schnittstelle für alle Arten digitaler Assets auf Solana:
  • Reguläre NFTs (Non-Fungible Token)
  • Komprimierte NFTs (cNFTs, mit Zustandskomprimierung)
  • Fungible Token (SPL Token und Token-2022, einschließlich Erweiterungen)
Ein einziger Methodensatz deckt Metadaten, Eigentumsinformationen, Guthaben, Sammlungen, Ersteller, Suche und Merkle-Beweise ab. So kannst du NFT-Marktplätze, Wallets, Portfolio-Tracker, Apps mit Token-Zugriff und Analysetools über dieselbe API entwickeln. Beide Netzwerke verwenden dieselben 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?

All asset types, one API

NFTs, komprimierte NFTs und fungible Token (SPL und Token-2022) über eine einzige Schnittstelle.

Complete metadata

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

Price data included

USD-Preisinformationen für verifizierte Token werden zusammen mit den Guthaben zurückgegeben.

Search and filtering

Suche nach Eigentümer, Sammlung, Ersteller, Autorität oder mit umfangreichen Attributfiltern.

​
Welche Methode sollte ich verwenden?

Die meisten Integrationen beginnen mit einer von drei Methoden. Wähle anhand dieser Tabelle den richtigen Einstiegspunkt aus und greife anschließend bei Bedarf auf die spezialisierten Methoden weiter unten zurück. Als Faustregel gilt:
  • Kennst du die genaue Asset-ID? Verwende getAsset (oder getAssetBatch für mehrere).
  • Möchtest du die Bestände einer Wallet auflisten? Verwende getAssetsByOwner.
  • Möchtest du nach Sammlung, Token-Typ oder Attributen filtern? Verwende searchAssets.

​
Wichtige Methoden

​
Einzelnes Asset

getAsset

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

getAssetBatch

Bis zu 1.000 Assets in einem einzigen request.

​
Assets nach Eigentümer, Sammlung oder Ersteller

getAssetsByOwner

Alle Assets in einer Wallet, einschließlich Metadaten und Guthaben.

getAssetsByGroup

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

getAssetsByCreator

Alle Assets, die von einem bestimmten Ersteller geprägt wurden.

getAssetsByAuthority

Alle Assets, die von einer bestimmten Autorität kontrolliert werden.

​
Suche

searchAssets

Flexible Filterung nach Eigentümer, Sammlung, tokenType und Attributen.

​
Komprimierte Assets und Beweise

getAssetProof

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

getAssetProofBatch

Merkle-Beweise für mehrere komprimierte Assets gleichzeitig.

getSignaturesForAsset

Verlauf der Transaktionssignaturen für ein Asset.

getNftEditions

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

​
Token-Konten

getTokenAccounts

Token-Konten nach Mint-Adresse oder Eigentümer, einschließlich Guthaben.

​
Erste Schritte

Get Assets (NFTs)

Rufe NFTs und digitale Sammlerstücke ab: einzelne Assets, Assets nach Eigentümer, Sammlungen, Beweise und Editionen.

Get SPL Tokens

Frage fungible Token ab: Guthaben, Umlaufmenge, Inhaber und Token-Konten.

Search Assets

Filtere Assets nach Eigentümer, Sammlung, Token-Typ und Attributen.

Pagination

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

​
Mit speziellen Asset-Typen arbeiten

​
Fungible Token

Helius erweitert die DAS API auf alle Token, einschließlich einfacher SPL Token (ohne Metadaten) und Token-2022 (einschließlich ihrer Erweiterungen). Fungible Token werden über getAsset, getAssetsByOwner und searchAssets mit dem Parameter tokenType unterstützt. Preise für verifizierte Token werden unter token_info.price_info zurückgegeben. Informationen zu Guthaben, Umlaufmenge, Inhabern und Abfragen von Token-Konten findest du im Leitfaden zum Abrufen von SPL Token und in der Erweiterung für fungible Token.

​
Komprimierte NFTs

Zustandskomprimierte NFTs (cNFTs) verwenden zum Lesen dieselben Methoden wie reguläre NFTs (getAsset, getAssetsByOwner, searchAssets) sowie zwei komprimierungsspezifische Methoden:
  • getAssetProof gibt den Merkle-Beweis zurück, der für die Verifizierung und für On-Chain-Operationen wie Übertragungen und Verbrennungen erforderlich ist.
  • getSignaturesForAsset gibt den Transaktionsverlauf eines komprimierten Assets zurück.
Vollständige Beispiele für komprimierte NFTs findest du im Leitfaden zum Abrufen von Assets.

​
Off-Chain-Daten

Die meisten NFT-Sammlungen speichern zusätzliche Metadaten wie Attribute und Bilder off-chain auf Arweave oder IPFS. Die DAS API indiziert diese Off-Chain-Daten und gibt sie zusammen mit den On-Chain-Daten in einem einzigen Aufruf zurück.
Helius kann Änderungen an Off-Chain-Daten nicht erkennen. Off-Chain-Daten werden erst aktualisiert, wenn das Asset erneut on-chain erfasst wird, beispielsweise nach einer Änderung. Kontaktiere den Helius-Support, um eine erneute Indizierung anzufordern.

​
Best Practices

Pagination

Beginne mit Seite 1, nicht mit Seite 0. Verwende Limits von 100 bis 1.000 und paginiere große Datensätze.

Error handling

Prüfe jede response auf Fehler und wiederhole fehlgeschlagene requests mit exponentiellem Backoff.

Performance

Verwende nach Möglichkeit Batch-Methoden, speichere responses im Cache und vermeide verkettete Aufrufe, wenn ein einzelner Aufruf ausreicht.

Security

Lege deinen API key niemals in clientseitigem Code offen. Leite requests über einen Server weiter und konfiguriere CORS-Richtlinien.

​
Nächste Schritte

Get Assets (NFTs)

Rufe NFTs und digitale Sammlerstücke ab und frage sie ab.

DAS API reference

Vollständige request- und response-Schemas für jede DAS-Methode.

DAS API FAQ

Häufige Fragen zu Assets, Preisdaten und Nutzung.