Comment utiliser getLargestAccounts

La méthode RPC getLargestAccounts renvoie une liste des 20 plus grands comptes du réseau Solana, classés par leur solde en lamports. Cette méthode peut être utile pour l’analyse du réseau, la compréhension de la distribution de la richesse ou l’identification des détenteurs significatifs de SOL. Notez que les résultats de cette méthode peuvent être mis en cache par le nœud RPC pendant deux heures maximum.

Cas d’utilisation courants

Surveillance de la santé du réseau : Observez la concentration de SOL dans les plus grands comptes.
Analyse économique : Étudiez la distribution de la richesse sur le réseau Solana.
Identification des baleines : Trouvez les comptes détenant des montants significatifs de SOL.

Paramètres de requête

Cette méthode peut prendre optionnellement un objet de configuration avec les paramètres suivants :

commitment (string, optionnel) : Spécifie le niveau d’engagement à utiliser lors de l’interrogation du registre. Si non fourni, l’engagement par défaut du nœud est utilisé.
filter (string, optionnel) : Filtre les résultats par type de compte. Les valeurs acceptées sont :
- circulating : Renvoie les plus grands comptes faisant partie de l’offre en circulation.
- nonCirculating : Renvoie les plus grands comptes ne faisant pas partie de l’offre en circulation (par exemple, comptes bloqués, comptes de la fondation). Si omis, tous les comptes sont considérés sans ce filtre spécifique.

Structure de la réponse

Le champ result de la réponse JSON-RPC sera un objet RpcResponse. Le champ value dans cet objet est un tableau de jusqu’à 20 objets compte, chacun contenant :

address (string) : La clé publique encodée en base-58 du compte.
lamports (u64) : Le solde du compte en lamports.

La réponse inclut également un objet context avec le slot auquel l’information a été récupérée.

Exemples

1. Obtenir les 20 plus grands comptes (sans filtre)

Cet exemple récupère les 20 plus grands comptes par solde en lamports sans aucun filtre d’offre.

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getLargestAccounts"
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function logLargestAccounts() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const largestAccounts = await connection.getLargestAccounts();
    console.log(`Largest Accounts (Slot: ${largestAccounts.context.slot}):`);
    largestAccounts.value.forEach((account, index) => {
      console.log(
        `  ${index + 1}. Address: ${account.address}, Balance: ${account.lamports / 10**9} SOL`
      );
    });
    // For full raw details:
    // console.log(JSON.stringify(largestAccounts, null, 2));
  } catch (error) {
    console.error('Error fetching largest accounts:', error);
  }
}

logLargestAccounts();

2. Obtenir les 20 plus grands comptes en circulation

Cet exemple récupère les 20 plus grands comptes considérés comme faisant partie de l’offre en circulation.

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getLargestAccounts",
    "params": [{ "filter": "circulating" }]
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function logLargestCirculatingAccounts() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const largestAccounts = await connection.getLargestAccounts({ filter: 'circulating' });
    console.log(`Largest Circulating Accounts (Slot: ${largestAccounts.context.slot}):`);
    largestAccounts.value.forEach((account, index) => {
      console.log(
        `  ${index + 1}. Address: ${account.address}, Balance: ${account.lamports / 10**9} SOL`
      );
    });
    // console.log(JSON.stringify(largestAccounts, null, 2));
  } catch (error) {
    console.error('Error fetching largest circulating accounts:', error);
  }
}

logLargestCirculatingAccounts();

Conseils pour les développeurs

Données en cache : Les résultats peuvent être mis en cache par le nœud RPC jusqu’à deux heures. Cela signifie que les données peuvent ne pas être en temps réel par rapport au dernier bloc.
Limité aux 20 premiers : Cette méthode ne renvoie que les 20 premiers comptes. Pour une analyse plus complète de la distribution de la richesse, d’autres sources de données ou méthodes peuvent être nécessaires.
Comportement des filtres : Les filtres circulating et nonCirculating dépendent de la définition et des sources de données du nœud RPC pour ces classifications.

Ce guide fournit les informations nécessaires pour utiliser la méthode RPC getLargestAccounts pour interroger les plus grands détenteurs de SOL sur le réseau Solana.

Commencez ici

Données en temps réel

Trading à faible latence

Données historiques et de portefeuille

Guides des méthodes RPC

Préparation à la production

Utilisation d'Orb

Autres modes d'emploi

Comment utiliser getLargestAccounts

Cas d’utilisation courants

Paramètres de requête

Structure de la réponse

Exemples

1. Obtenir les 20 plus grands comptes (sans filtre)

2. Obtenir les 20 plus grands comptes en circulation

Conseils pour les développeurs

​Cas d’utilisation courants

​Paramètres de requête

​Structure de la réponse

​Exemples

​1. Obtenir les 20 plus grands comptes (sans filtre)

​2. Obtenir les 20 plus grands comptes en circulation

​Conseils pour les développeurs

Cas d’utilisation courants

Paramètres de requête

Structure de la réponse

Exemples

1. Obtenir les 20 plus grands comptes (sans filtre)

2. Obtenir les 20 plus grands comptes en circulation

Conseils pour les développeurs