Solana Fungible Token API : Accès complet aux données des tokens

Aperçu

Initialement, l’API DAS ne supportait que les requêtes de propriété pour les NFTs Metaplex et cNFTs. Helius a étendu l’API DAS pour supporter tous les tokens, y compris les tokens SPL simples (sans métadonnées) et Token-2022 (plus leurs extensions). Vous pouvez interroger les soldes de tokens de n’importe quel compte à travers tous les tokens (SPL, Token-2022, NFTs, et NFTs compressés), avec les prix des tokens en USD inclus. Un token Solana est défini par son compte de mint. Par exemple, le compte de mint pour l’USDC est EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Lorsque vous achetez 40 $ d’USDC, un compte de token est créé qui contient 40 tokens USDC. Un portefeuille peut contenir des centaines de comptes de tokens pour différents tokens. Pour en savoir plus sur Token-2022, consultez le billet de blog de Helius.

Quand l’utiliser

Utilisez l’extension de tokens fongibles lorsque vous souhaitez avoir une vue unifiée des actifs d’un compte — tokens fongibles, NFTs, et NFTs compressés — en un seul appel DAS, avec métadonnées et prix USD. C’est le bon choix pour les traqueurs de portefeuille, portefeuilles et tableaux de bord de tokens. Utilisez les méthodes standard RPC de tokens (getTokenAccountBalance, getTokenAccountsByOwner, getTokenSupply, getTokenLargestAccounts) lorsque vous avez seulement besoin des valeurs brutes sur la chaîne — un seul solde de compte, l’offre totale, ou les plus grands détenteurs — sans métadonnées ou prix. Consultez le guide des tokens SPL pour cela.

Comment ça fonctionne

L’extension Helius pour les tokens fongibles repose sur l’indexation de la propriété. Les méthodes suivantes fournissent une vue unifiée des actifs d’un compte : getAsset, getAssetsByOwner, et searchAssets. L’extension ajoute un champ supplémentaire appelé tokenType, qui vous permet de faire des requêtes sur tous les actifs que possède le compte, y compris les tokens fongibles et Token-2022. Les options pour tokenType sont :

fungible : Retourne tous les tokens fongibles.
nonFungible : Retourne tous les NFTs (compressés et réguliers).
regularNft : Retourne uniquement les NFTs réguliers.
compressedNft : Retourne uniquement les NFTs compressés.
all : Retourne tous les tokens.

Exemple de requête :

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

La réponse inclut maintenant des tokens fongibles comme JitoSOL. Chaque élément contient le solde total du compte, l’adresse du programme du token, l’adresse associée au token, l’offre totale en circulation, et les informations de prix. L’élément ci-dessous montre les champs pertinents :

{
    "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"
        }
    }
    // ...
}

Prise en charge de Token-2022

Helius supporte les tokens Token-2022 et analyse leurs extensions. La réponse inclut le champ mint_extensions si le token utilise le programme Token-2022. L’élément ci-dessous montre le champ mint_extensions pour 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"
        }
    }
    // ...
}

Compatibilité ascendante

Pour la compatibilité ascendante, le comportement est identique à l’original DAS lorsque tokenType est omis : seuls les NFTs et NFTs compressés sont retournés.

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

Étapes suivantes

Obtenir des tokens SPL

Soldes, offre, détenteurs, et comptes de tokens.

Rechercher des actifs

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

référence searchAssets

Schémas complets de requête et de réponse.

Commencer

Diffusion de données et écoute d'événements

API de données et RPC

Trading

Envoyer des transactions

Wallet en tant que service

Confidentialité

Ressources

Solana Fungible Token API : Accès complet aux données des tokens

Aperçu

Quand l’utiliser

Comment ça fonctionne

Prise en charge de Token-2022

Compatibilité ascendante

Étapes suivantes

Obtenir des tokens SPL

Rechercher des actifs

référence searchAssets

​Aperçu

​Quand l’utiliser

​Comment ça fonctionne

​Prise en charge de Token-2022

​Compatibilité ascendante

​Étapes suivantes

Obtenir des tokens SPL

Rechercher des actifs

référence searchAssets

Aperçu

Quand l’utiliser

Comment ça fonctionne

Prise en charge de Token-2022

Compatibilité ascendante

Étapes suivantes