Solana-API für fungible token: Vollständiger Zugriff auf token-Daten

Übersicht

Ursprünglich unterstützte die DAS API nur Eigentumsabfragen für Metaplex-NFTs und cNFTs. Helius hat die DAS API um die Unterstützung für alle token erweitert. Dazu gehören einfache SPL-token ohne Metadaten sowie Token-2022 und dessen Erweiterungen. Du kannst die token-Guthaben jedes Kontos über alle token hinweg abfragen, einschließlich SPL, Token-2022, NFTs und komprimierter NFTs. Preise in USD sind ebenfalls enthalten. Ein Solana-token wird durch sein Mint-Konto definiert. Das Mint-Konto für USDC ist beispielsweise EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Wenn du USDC im Wert von 40 $ kaufst, wird ein token account erstellt, der 40 USDC-token enthält. Eine Wallet kann Hunderte von token accounts für verschiedene token enthalten. Weitere Informationen zu Token-2022 findest du im Blogbeitrag von Helius.

Wann du diese Erweiterung verwenden solltest

Verwende die Erweiterung für fungible token, wenn du eine einheitliche Ansicht der Assets eines Kontos benötigst — fungible token, NFTs und komprimierte NFTs — in einem einzigen DAS-Aufruf, einschließlich Metadaten und Preisen in USD. Sie ist die richtige Wahl für Portfolio-Tracker, Wallets und token-Dashboards. Verwende die standardmäßigen RPC-Methoden für token (getTokenAccountBalance, getTokenAccountsByOwner, getTokenSupply, getTokenLargestAccounts), wenn du nur unverarbeitete Onchain-Werte benötigst — etwa den Kontostand eines einzelnen Kontos, die Gesamtmenge oder die größten Inhaber — und keine Metadaten oder Preise. Weitere Informationen findest du im Leitfaden SPL-token abrufen.

Funktionsweise

Die Helius-Erweiterung für fungible token basiert auf der Indexierung von Eigentumsverhältnissen. Die folgenden Methoden bieten eine einheitliche Ansicht der Assets eines Kontos: getAsset, getAssetsByOwner und searchAssets. Die Erweiterung fügt ein zusätzliches Feld namens tokenType hinzu. Damit kannst du alle Assets abfragen, die dem Konto gehören, einschließlich fungibler token und Token-2022-token. Für tokenType stehen folgende Optionen zur Verfügung:

fungible: Gibt alle fungiblen token zurück.
nonFungible: Gibt alle NFTs zurück, sowohl komprimierte als auch reguläre.
regularNft: Gibt nur reguläre NFTs zurück.
compressedNft: Gibt nur komprimierte NFTs zurück.
all: Gibt alle token zurück.

Beispiel-request:

{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze",
        "tokenType": "all"
    }
}

Die response enthält jetzt auch fungible token wie JitoSOL. Jedes Element enthält das gesamte Kontoguthaben, die Adresse des token program, die zugehörige token address, die gesamte Umlaufmenge und die Preisinformationen. Das gekürzte Element unten zeigt die relevanten Felder:

{
    "id": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
    "content": {
        "$schema": "",
        "json_uri": "",
        "metadata": {
            "description": "MEV-Powered Liquid Staking Derivative",
            "name": "Jito Staked SOL",
            "symbol": "JitoSOL",
            "token_standard": "Fungible"
        }
        // ...
    },
    "token_info": {
        "symbol": "JitoSOL",
        "balance": 35688813508,
        "supply": 5949594702758293,
        "decimals": 9,
        "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        "associated_token_address": "H7iLu4DPFpzEx1AGN8BCN7Qg966YFndt781p6ukhgki9",
        "price_info": {
            "price_per_token": 56.47943,
            "total_price": 2015.6838854339217,
            "currency": "USDC"
        }
    }
    // ...
}

Unterstützung für Token-2022

Helius unterstützt Token-2022-token und analysiert deren Erweiterungen. Die response enthält das Feld mint_extensions, wenn der token das Token-2022-Programm verwendet. Das gekürzte Element unten zeigt das Feld mint_extensions für BERN:

{
    "mint_extensions": {
        "transfer_fee_config": {
            "withheld_amount": 0,
            "newer_transfer_fee": {
                "epoch": 457,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 690
            },
            "older_transfer_fee": {
                "epoch": 455,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 0
            },
            "withdraw_withheld_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD",
            "transfer_fee_config_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD"
        }
    }
    // ...
}

Abwärtskompatibilität

Aus Gründen der Abwärtskompatibilität ist das Verhalten mit dem ursprünglichen DAS identisch, wenn tokenType nicht angegeben wird: Es werden nur NFTs und komprimierte NFTs zurückgegeben.

{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze"
    }
}

Nächste Schritte

Get SPL Tokens

Guthaben, Gesamtmenge, Inhaber und token accounts.

Search Assets

Filtere nach tokenType, Eigentümer und Sammlung.

searchAssets reference

Vollständige Schemas für request und response.

Erste Schritte

Streaming von Daten und Event-Überwachung

Daten-APIs und RPCs

Trading

Transaktionen senden

Wallet-as-a-Service

Datenschutz

Ressourcen

Solana-API für fungible token: Vollständiger Zugriff auf token-Daten

Übersicht

Wann du diese Erweiterung verwenden solltest

Funktionsweise

Unterstützung für Token-2022

Abwärtskompatibilität

Nächste Schritte

Get SPL Tokens

Search Assets

searchAssets reference

​Übersicht

​Wann du diese Erweiterung verwenden solltest

​Funktionsweise

​Unterstützung für Token-2022

​Abwärtskompatibilität

​Nächste Schritte

Get SPL Tokens

Search Assets

searchAssets reference

Übersicht

Wann du diese Erweiterung verwenden solltest

Funktionsweise

Unterstützung für Token-2022

Abwärtskompatibilität

Nächste Schritte