Comment obtenir des jetons Solana SPL : Guide complet de l'API

Vue d’ensemble

Ce guide couvre la lecture des jetons fongibles sur Solana : soldes des comptes, comptes de jetons par propriétaire ou émission, approvisionnement total, plus grands détenteurs, et l’extension de jetons fongibles DAS. Helius expose à la fois les méthodes de jetons RPC standard Solana et les méthodes DAS qui ajoutent des métadonnées et des prix en USD. Pour les NFT, NFT compressés, éditions et preuves, consultez le guide Obtenir des actifs. Cette page se concentre sur les jetons fongibles (SPL et Token-2022).

Quand utiliser ceci

Utilisez les méthodes de cette page lorsque vous :

Lisez le solde d’un seul compte de jeton
Listez tous les comptes de jetons qu’un portefeuille détient
Trouvez tous les comptes qui détiennent une émission spécifique
Vérifiez l’approvisionnement total d’un jeton ou ses plus grands détenteurs
Récupérez les métadonnées du jeton et le prix en USD en plus des soldes

Solde du compte de jetons

Obtenez le solde pour un compte de jeton spécifique en utilisant le RPC standard :

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenAccountBalance',
    params: [
      '3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa'
    ]
  })
});
const data = await response.json();
console.log(data);

Référence de l'API

getTokenAccountBalance

Comptes de jetons par propriétaire

Listez tous les comptes de jetons détenus par un portefeuille :

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenAccountsByOwner',
    params: [
      '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
      {
        programId: 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA'
      },
      {
        encoding: 'jsonParsed'
      }
    ]
  })
});
const data = await response.json();
console.log(data);

Référence de l'API

getTokenAccountsByOwner

Comptes de jetons par émission

Listez tous les comptes détenant un jeton spécifique :

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenAccountsByOwner',
    params: [
      'CEXq1uy9y15PL2Wb4vDQwQfcJakBGjaAjeuR2nKLj8dk',
      {
        mint: "8wXtPeU6557ETkp9WHFY1n1EcU6NxDvbAggHGsMYiHsB"
      },
      {
        encoding: 'jsonParsed'
      }
    ]
  })
});
const data = await response.json();
console.log(data);

Référence de l'API

getTokenAccountsByOwner

Pour trouver chaque compte détenant une émission parmi tous les propriétaires (pas seulement un propriétaire), utilisez la méthode DAS getTokenAccounts décrite ci-dessous.

Approvisionnement en jetons

Vérifiez l’approvisionnement total d’un jeton :

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenSupply',
    params: [
      'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
    ]
  })
});
const data = await response.json();
console.log(data);

Référence de l'API

getTokenSupply

Plus grands détenteurs de jetons

Identifiez les plus grands comptes détenant un jeton :

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenLargestAccounts',
    params: [
      'he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A'
    ]
  })
});
const data = await response.json();
console.log(data);

Référence de l'API

getTokenLargestAccounts

Retourne jusqu’à 20 des plus grands comptes pour l’émission :

{
  "context": { "slot": 0 },
  "value": [
    { "address": "...", "amount": "1000000000000", "decimals": 9, "uiAmount": 1000.0, "uiAmountString": "1000" }
  ]
}

Comptes de jetons avec l’API DAS

La méthode DAS getTokenAccounts retourne les comptes de jetons par émission ou propriétaire, y compris les soldes, en un seul appel paginé. Contrairement à getTokenAccountsByOwner, vous pouvez interroger par mint seul pour lister chaque compte détenant un jeton parmi tous les propriétaires.

const url = `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`;

const getTokenAccounts = async (params) => {
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: "my-request-id",
      method: "getTokenAccounts",
      params: params,
    }),
  });

  const { result } = await response.json();
  return result;
};

// Example: Get all accounts holding a specific token
getTokenAccounts({
  mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", // USDC
  page: 1,
  limit: 100
});

Référence de l'API

getTokenAccounts

Paginé; chaque entrée inclut le compte, l’émission, le propriétaire et le solde :

{
  "total": 100,
  "limit": 100,
  "page": 1,
  "token_accounts": [
    { "address": "...", "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "owner": "...", "amount": 12345678 }
  ]
}

Métadonnées de jetons et prix avec l’API DAS

Pour les métadonnées de jetons et le prix en USD, appelez la méthode DAS getAsset avec showFungible activé. Les prix pour les jetons vérifiés sont retournés sous token_info.price_info.

Les données de prix de getAsset sont mises en cache pendant jusqu’à 600 secondes, elles peuvent donc être vieilles jusqu’à 10 minutes.

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getAsset',
    params: {
      id: 'DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263', // Bonk
      options: {
        showFungible: true
      }
    }
  })
});
const { result } = await response.json();
console.log(result.token_info.price_info);

Référence de l'API

getAsset

La réponse retourne l’approvisionnement, les décimales et le prix sous token_info :

{
  "token_info": {
    "symbol": "Bonk",
    "supply": 8881594973561640000,
    "decimals": 5,
    "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "price_info": {
      "price_per_token": 0.0000192271,
      "currency": "USDC"
    }
  }
}

Calculer la capitalisation boursière

Multipliez le prix par l’approvisionnement ajusté aux décimales :

const { price_per_token } = result.token_info.price_info;
const { supply, decimals } = result.token_info;
const marketCap = (supply / Math.pow(10, decimals)) * price_per_token;

Pour lister chaque jeton fongible d’un portefeuille (avec soldes et prix) en un seul appel, utilisez getAssetsByOwner ou searchAssets avec tokenType: "fungible". Voir l’extension de jetons fongibles pour savoir comment tokenType, les soldes, les extensions Token-2022 et les données de prix apparaissent dans la réponse.

Meilleures pratiques

Utilisez la pagination pour les méthodes qui retournent de grands ensembles de résultats. Consultez le guide de pagination.
Préférez les méthodes DAS (getAsset, getAssetsByOwner, getTokenAccounts) lorsque vous avez besoin de métadonnées ou de prix en USD ; utilisez les méthodes RPC standard pour les soldes et approvisionnements bruts sur la chaîne.
Gérez les erreurs de manière gracieuse avec des blocs try/catch et des tentatives répétées.
Mettez en cache les réponses lorsque c’est approprié pour réduire les appels API.

Prochaines étapes

Extension de jetons fongibles

Comment DAS retourne les jetons fongibles, extensions Token-2022, et prix.

Obtenir des actifs (NFTs)

Récupérez des NFTs, NFTs compressés, éditions et preuves.

Référence API DAS

Schémas complets pour chaque méthode DAS.

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

Comment obtenir des jetons Solana SPL : Guide complet de l'API

Vue d’ensemble

Quand utiliser ceci

Solde du compte de jetons

Référence de l'API

Comptes de jetons par propriétaire

Référence de l'API

Comptes de jetons par émission

Référence de l'API

Approvisionnement en jetons

Référence de l'API

Plus grands détenteurs de jetons

Référence de l'API

Comptes de jetons avec l’API DAS

Référence de l'API

Métadonnées de jetons et prix avec l’API DAS

Référence de l'API

Calculer la capitalisation boursière

Meilleures pratiques

Prochaines étapes

Extension de jetons fongibles

Obtenir des actifs (NFTs)

Référence API DAS

​Vue d’ensemble

​Quand utiliser ceci

​Solde du compte de jetons

Référence de l'API

​Comptes de jetons par propriétaire

Référence de l'API

​Comptes de jetons par émission

Référence de l'API

​Approvisionnement en jetons

Référence de l'API

​Plus grands détenteurs de jetons

Référence de l'API

​Comptes de jetons avec l’API DAS

Référence de l'API

​Métadonnées de jetons et prix avec l’API DAS

Référence de l'API

​Calculer la capitalisation boursière

​Meilleures pratiques

​Prochaines étapes

Extension de jetons fongibles

Obtenir des actifs (NFTs)

Référence API DAS

Vue d’ensemble

Quand utiliser ceci

Solde du compte de jetons

Comptes de jetons par propriétaire

Comptes de jetons par émission

Approvisionnement en jetons

Plus grands détenteurs de jetons

Comptes de jetons avec l’API DAS

Métadonnées de jetons et prix avec l’API DAS

Calculer la capitalisation boursière

Meilleures pratiques

Prochaines étapes