> ## 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.
# getAsset
> Rufen Sie detaillierte Informationen für ein einzelnes Solana NFT, komprimiertes NFT oder Token ab, einschließlich Metadaten, Eigentum, Preisdaten und On-Chain-Attribute.
## Zwischenspeicherung von Preisdaten
Die von getAsset zurückgegebenen Preisdaten sind zwischengespeichert und möglicherweise nicht aktuell. Die Preisinformationen haben einen Cache von 600 Sekunden, was bedeutet, dass die Daten bis zu 600 Sekunden alt sein können.
Preisdaten sind für die Top-10.000-Token nach 24-Stunden-Volumen verfügbar und können im Abschnitt `token_info.price_info` der Antwort gefunden werden. Für Anwendungen, die Echtzeitpreise benötigen, sollten Sie zusätzliche Validierungen in Betracht ziehen.
## MPL Core-Agenten und MIP-11-Gruppen
Wenn vorhanden, kann die Antwort `is_agent`, `agent_token`, `asset_signer`, `interface` Werte wie `MplCoreGroup` und ein `plugins.groups`-Objekt für die MIP-11-Mitgliedschaft enthalten. Dieselben optionalen Felder werden von `getAssetBatch`, `getAssetsByOwner`, `getAssetsByGroup`, `getAssetsByCreator`, `getAssetsByAuthority` und `searchAssets` zurückgegeben. Siehe den [Asset-Suchleitfaden](/docs/de/das/search) für `searchAssets` Filter.
## Anfrageparameter
Der eindeutige Bezeichner des Solana NFT oder digitalen Assets, das abgerufen werden soll. Dies ist typischerweise die Mint-Adresse des NFT oder Tokens.
Anzeige- und Formatierungsoptionen für die Asset-Datenantwort.
Zeigt Gruppierungsinformationen für nicht verifizierte Sammlungen an, anstatt sie zu überspringen.
Zeigt Metadaten für die Sammlung an.
Zeigt fungible Token an, die vom Besitzer gehalten werden.
## OpenAPI
````yaml de/openapi/das-api/getAsset.yaml POST /
openapi: 3.1.0
info:
title: Solana Digital Asset Standard (DAS) API
version: 1.0.0
description: >-
Die Solana Digital Asset Standard (DAS) API bietet einen umfassenden und
standardisierten Zugang zu NFTs und digitalen Assets auf der
Solana-Blockchain.
Dieses leistungsstarke API-Set ermöglicht Entwicklern das Abrufen
detaillierter Informationen über jedes digitale Asset auf Solana,
einschließlich sowohl traditioneller als auch komprimierter NFTs, mit
konsistenter Datenformatierung unabhängig vom Token-Standard.
Jede erfolgreiche DAS-Antwort enthält ein `last_indexed_slot`-Feld, das den
zuletzt indizierten Slot anzeigt, für den der DAS-Index garantiert
vollständig ist. Alle On-Chain-Daten **bis einschließlich** dieses Slots
wurden indiziert. Daten, die über diesen Slot hinausgehen, könnten ebenfalls
bereits indiziert worden sein,
obwohl dies nicht garantiert ist.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Mainnet RPC-Endpunkt
- url: https://devnet.helius-rpc.com
description: Devnet RPC-Endpunkt
security: []
paths:
/:
post:
tags:
- RPC
summary: getAsset
description: >
Abrufen umfassender Daten für ein beliebiges Solana-NFT oder digitales
Asset anhand seiner eindeutigen Kennung.
Dieser Endpunkt bietet vollständige On-Chain- und Off-Chain-Metadaten,
Eigentumsdetails, Lizenzinformationen,
Sammlungsdaten und den Komprimierungsstatus für jedes
Solana-Digital-Asset. Die getAsset-Methode unterstützt alle
Token-Standards,
einschließlich komprimierter NFTs (cNFTs), programmierbarer NFTs (pNFTs)
und traditioneller SPL-Token.
Verwenden Sie diesen Endpunkt, um:
- Vollständige Metadaten für NFT-Marktplatzangebote abzurufen
- Eigentumsinformationen für Wallet-Integrationen abzurufen
- Lizenz- und Erstellerdaten für Lizenzdurchsetzung zu erhalten
- Komprimierungsstatus zu überprüfen, um kostengünstige komprimierte
NFTs zu identifizieren
- Sammlungsgruppierungen für NFT-Sammlungsanalysen anzuzeigen
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: Die JSON-RPC-Protokollversion.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: Eine eindeutige Kennung für die Anfrage.
example: '1'
default: '1'
method:
type: string
description: Der Name der RPC-Methode, die aufgerufen werden soll.
enum:
- getAsset
default: getAsset
params:
type: object
default:
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
id:
type: string
description: >-
Die eindeutige Kennung des Solana-NFTs oder digitalen
Assets, das abgerufen werden soll. Dies ist
typischerweise die Mint-Adresse des NFTs oder Tokens.
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: >-
Anzeige- und Formatierungsoptionen für die Antwort auf
Asset-Daten.
properties:
showUnverifiedCollections:
type: boolean
default: false
description: >-
Zeigt Gruppierungsinformationen für nicht
verifizierte Sammlungen an, anstatt sie zu
überspringen.
showCollectionMetadata:
type: boolean
default: false
description: Zeigt Metadaten für die Sammlung an.
showFungible:
type: boolean
description: >-
Zeigt fungible Tokens an, die vom Eigentümer
gehalten werden.
default: false
responses:
'200':
description: Erfolgreiche Antwort
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Die Version des JSON-RPC-Protokolls.
id:
type: string
description: >-
Die ID, die zur Identifizierung der Anfrage verwendet
wird.
result:
type: object
properties:
last_indexed_slot:
type: integer
description: >-
Alle Daten bis einschließlich dieses Slots wurden
garantiert indiziert.
interface:
type: string
description: >-
Der Schnittstellentyp des Solana-Digital-Assets, der
seinen Token-Standard und seine Implementierung
angibt.
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
Ob dieses Asset eine Agentenidentität hat. Nur wahr
für MPL-Core-Assets, die den AgentIdentity-Adapter für
externe Plugins verwenden. Standardmäßig auf false
gesetzt und wird bei false von der Antwort
weggelassen.
agent_token:
type: string
description: >-
Base58-kodierte Mint-Adresse des Agenten-Tokens aus
dem Agenten-Registrierungsprogramm. Wird weggelassen,
wenn das Asset keinen entsprechenden
Registrierungseintrag hat.
asset_signer:
type: string
description: >-
Base58-kodierter PDA, der für das Signieren im Namen
des Assets verwendet wird; deterministisch von der
Asset-ID für MPL-Core-Assets abgeleitet. Wird
weggelassen, wenn nicht zutreffend.
id:
type: string
description: Die eindeutige Kennung des Assets.
content:
type: object
description: >-
Inhaltsinformationen des Solana-Digital-Assets,
einschließlich Metadaten, Dateien und Links.
properties:
$schema:
type: string
description: Die Schema-URL für die Asset-Metadaten.
json_uri:
type: string
description: >-
URI, der auf die JSON-Metadaten für das Solana-NFT
verweist, typischerweise auf Arweave oder anderem
dezentralen Speicher gehostet.
files:
type: array
description: >-
Array von Dateien, die mit dem Asset verknüpft
sind.
items:
type: object
metadata:
type: object
description: >-
Vollständige Metadateninformationen zum
Solana-Digital-Asset, einschließlich Name, Symbol,
Attribute und Token-Standard.
properties:
name:
type: string
description: Der Name des Assets.
symbol:
type: string
description: Das Symbol des Assets.
attributes:
type: array
description: Array von Merkmalsattributen.
items:
type: object
properties:
value:
type: string
description: Der Wert des Merkmals.
trait_type:
type: string
description: Der Typ des Merkmals.
description:
type: string
description: Beschreibung des Assets.
token_standard:
type: string
description: Verwendeter Token-Standard.
links:
type: object
description: Externe Links, die mit dem Asset verbunden sind.
authorities:
type: array
description: Liste der mit dem Asset verbundenen Behörden.
items:
type: object
properties:
address:
type: string
description: Die Adresse der Behörde.
scopes:
type: array
description: Die Zuständigkeitsbereiche der Behörde.
items:
type: string
compression:
type: object
description: >-
Komprimierungsdetails des Solana-Digital-Assets, die
angeben, ob es sich um ein komprimiertes NFT mit
Zustandsnachweisvalidierung handelt.
properties:
eligible:
type: boolean
description: Ob das Asset für die Komprimierung geeignet ist.
compressed:
type: boolean
description: >-
Ob das Asset momentan mit Solanas
Zustandkomprimierungstechnologie komprimiert ist,
was die Speicherkosten reduziert.
data_hash:
type: string
description: Hash der Asset-Daten.
creator_hash:
type: string
description: Hash der Ersteller-Daten.
asset_hash:
type: string
description: Hash des gesamten Assets.
tree:
type: string
description: Merkle-Baum-Adresse.
seq:
type: integer
description: Sequenznummer.
leaf_id:
type: integer
description: Blattkennzeichen im Merkle-Baum.
grouping:
type: array
description: Gruppierungsinformationen für das Asset.
items:
type: object
properties:
group_key:
type: string
description: Der Schlüssel, der die Gruppe identifiziert.
group_value:
type: string
description: Der Wert, der mit der Gruppe verbunden ist.
royalty:
type: object
description: >-
Lizenzinformationen für das Solana-Digital-Asset,
verwendet für die Berechnung von Marktplatzgebühren
und Zahlungen an Ersteller.
properties:
royalty_model:
type: string
description: Das verwendete Modell für Lizenzen.
target:
type:
- string
- 'null'
description: Die Zieladresse für Lizenzen.
percent:
type: number
description: Lizenzprozentsatz.
basis_points:
type: integer
description: Lizenzbasispunkte.
primary_sale_happened:
type: boolean
description: Ob der Primärverkauf stattgefunden hat.
locked:
type: boolean
description: Ob die Lizenz gesperrt ist.
creators:
type: array
description: Liste der Ersteller des Assets.
items:
type: object
properties:
address:
type: string
description: Die Adresse des Erstellers.
share:
type: integer
description: Der Anteil des Erstellers in Prozent.
verified:
type: boolean
description: Ob der Ersteller verifiziert ist.
ownership:
type: object
description: >-
Eigentumsdetails des Solana-Digital-Assets,
einschließlich aktuellem Eigentümer, Delegationsstatus
und Einfrierinformationen.
required:
- frozen
- delegated
- ownership_model
- owner
properties:
frozen:
type: boolean
description: Ob das Asset eingefroren ist.
delegated:
type: boolean
description: Ob das Asset delegiert ist.
delegate:
type:
- string
- 'null'
description: Die Adresse des Delegierten, falls delegiert.
ownership_model:
type: string
description: Das Eigentumsmodell.
owner:
type: string
description: Die Adresse des Eigentümers.
supply:
type:
- object
- 'null'
description: Versorgungsinformationen für das Asset.
properties:
print_max_supply:
type: integer
description: Maximale Versorgung, die gedruckt werden kann.
print_current_supply:
type: integer
description: Aktuell gedruckte Versorgung.
edition_nonce:
type: integer
description: Editions-Nachweisnummer.
mutable:
type: boolean
description: Ob das Asset veränderbar ist.
burnt:
type: boolean
description: Ob das Asset verbrannt wurde.
token_info:
type: object
description: Tokenspezifische Informationen.
properties:
supply:
type: integer
description: Gesamte Token-Versorgung.
decimals:
type: integer
description: Anzahl der Dezimalstellen.
token_program:
type: string
description: Token-Programm-ID.
mint_authority:
type: string
description: Mint-Authority-Adresse.
freeze_authority:
type: string
description: Einfrier-Authority-Adresse.
plugins:
type: object
description: >-
MPL-Core-Plugin-Nutzlast. Kann ein `groups`-Plugin
(MIP-11) auf Assets und Sammlungen enthalten.
additionalProperties: true
properties:
groups:
type: object
description: >-
MIP-11-Gruppen-Plugin mit
Mitgliedschaftsmetadaten.
properties:
authority:
type: object
description: >-
Plugin-Authority (zum Beispiel,
UpdateAuthority).
additionalProperties: true
data:
type: object
properties:
groups:
type: array
description: >-
Gruppenmitgliedschaften für dieses Asset
oder Sammlung.
items:
type: object
properties:
group_address:
type: string
description: >-
Base58-Adresse des
MPL-Core-Gruppenkontos.
member_number:
type: integer
description: Mitgliedsnummer innerhalb der Gruppe.
examples:
success:
value:
jsonrpc: '2.0'
id: test
result:
last_indexed_slot: 365749093
interface: ProgrammableNFT
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
content:
$schema: https://schema.metaplex.com/nft1.0.json
json_uri: >-
https://madlads.s3.us-west-2.amazonaws.com/json/8420.json
files:
- uri: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
mime: image/png
- uri: >-
https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
mime: image/png
metadata:
attributes:
- value: Male
trait_type: Gender
- value: King
trait_type: Type
- value: Royal
trait_type: Expression
- value: Mad Crown
trait_type: Hat
- value: Madness
trait_type: Eyes
- value: Mad Armor
trait_type: Clothing
- value: Royal Rug
trait_type: Background
description: Fock it.
name: 'Mad Lads #8420'
symbol: MAD
token_standard: ProgrammableNonFungible
links:
image: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
external_url: https://madlads.com
authorities:
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
scopes:
- full
compression:
eligible: false
compressed: false
data_hash: ''
creator_hash: ''
asset_hash: ''
tree: ''
seq: 0
leaf_id: 0
grouping:
- group_key: collection
group_value: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
royalty:
royalty_model: creators
target: null
percent: 0.042
basis_points: 420
primary_sale_happened: true
locked: false
creators:
- address: 5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv
share: 0
verified: true
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
share: 100
verified: true
ownership:
frozen: true
delegated: false
delegate: null
ownership_model: single
owner: 4zdNGgAtFsW1cQgHqkiWyRsxaAgxrSRRynnuunxzjxue
supply:
print_max_supply: 0
print_current_supply: 0
edition_nonce: 254
mutable: true
burnt: false
token_info:
supply: 1
decimals: 0
token_program: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
mint_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
freeze_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
'400':
description: >-
Ungültige Anfrage. Der Server konnte die Anfrage aufgrund ungültiger
Syntax nicht verstehen.
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: Ungültige Anforderungsparameter.
id:
type: string
example: '1'
'401':
description: >-
Nicht autorisiert. Der Client muss sich authentifizieren, um die
angeforderte Antwort zu erhalten.
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: >-
Authentifizierung fehlgeschlagen. Fehlender oder
ungültiger API-Schlüssel.
id:
type: string
example: '1'
'403':
description: Verboten. Der Client hat keine Zugriffsrechte auf den Inhalt.
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: >-
Sie haben keine Berechtigung, auf diese Ressource
zuzugreifen.
id:
type: string
example: '1'
'404':
description: >-
Nicht gefunden. Der Server kann die angeforderte Ressource nicht
finden.
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: Das angeforderte Asset wurde nicht gefunden.
id:
type: string
example: '1'
'429':
description: >-
Zu viele Anfragen. Der Benutzer hat in einem bestimmten Zeitraum zu
viele Anfragen gesendet.
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: >-
Rate-Limit überschritten. Bitte versuchen Sie es
später erneut.
id:
type: string
example: '1'
'500':
description: >-
Interner Serverfehler. Der Server hat eine Situation festgestellt,
mit der er nicht umgehen kann.
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: >-
Ein unerwarteter Fehler ist auf dem Server
aufgetreten.
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Ihr Helius API-Schlüssel. Sie können einen kostenlos im
[Dashboard](https://dashboard.helius.dev/api-keys) erhalten.
````