So rufst du Solana SPL Token ab: vollständiger API-Leitfaden

Übersicht

Dieser Leitfaden erklärt, wie du fungible Token auf Solana ausliest: Kontoguthaben, Konten für Token nach Besitzer oder Mint, das Gesamtangebot, die größten Inhaber und die DAS-Erweiterung für fungible Token. Helius stellt sowohl standardmäßige Solana RPC-Methoden für Token als auch DAS-Methoden bereit, die Metadaten und USD-Preise hinzufügen. Informationen zu NFTs, komprimierten NFTs, Editionen und Nachweisen findest du im Leitfaden zum Abrufen von Assets. Diese Seite konzentriert sich auf fungible Token (SPL und Token-2022).

Wann du diese Methoden verwenden solltest

Verwende die Methoden auf dieser Seite, wenn du Folgendes tun möchtest:

Das Guthaben eines einzelnen Kontos für Token auslesen
Alle Konten für Token auflisten, die eine Wallet besitzt
Alle Konten finden, die einen bestimmten Mint halten
Das Gesamtangebot eines Token oder seine größten Inhaber prüfen
Metadaten und USD-Preis eines Token zusammen mit den Guthaben abrufen

Guthaben eines Kontos für Token

Rufe das Guthaben eines bestimmten Kontos für Token mit standardmäßigem RPC ab:

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);

API Reference

getTokenAccountBalance

Konten für Token nach Besitzer

Liste alle Konten für Token auf, die einer Wallet gehören:

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);

API Reference

getTokenAccountsByOwner

Konten für Token nach Mint

Liste alle Konten auf, die einen bestimmten Token halten:

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);

API Reference

getTokenAccountsByOwner

Um alle Konten zu finden, die einen Mint besitzerübergreifend halten, statt nur die Konten eines einzelnen Besitzers, verwende die unten beschriebene DAS-Methode getTokenAccounts.

Gesamtangebot eines Token

Prüfe das Gesamtangebot eines Token:

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);

API Reference

getTokenSupply

Größte Inhaber eines Token

Ermittle die größten Konten, die einen Token halten:

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);

API Reference

getTokenLargestAccounts

Gibt bis zu 20 der größten Konten für den Mint zurück:

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

Konten für Token mit der DAS API

Die DAS-Methode getTokenAccounts gibt Konten für Token nach Mint oder Besitzer einschließlich ihrer Guthaben in einem einzelnen paginierten Aufruf zurück. Anders als bei getTokenAccountsByOwner kannst du ausschließlich nach mint abfragen, um alle Konten aufzulisten, die besitzerübergreifend einen Token halten.

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
});

API Reference

getTokenAccounts

Die Ergebnisse sind paginiert. Jeder Eintrag enthält das Konto, den Mint, den Besitzer und das Guthaben:

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

Metadaten und Preis eines Token mit der DAS API

Um Metadaten und den USD-Preis eines Token abzurufen, rufe die DAS-Methode getAsset mit aktiviertem showFungible auf. Preise für verifizierte Token werden unter token_info.price_info zurückgegeben.

Preisdaten von getAsset werden bis zu 600 Sekunden zwischengespeichert und können daher bis zu 10 Minuten alt sein.

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);

API Reference

getAsset

Die response gibt das Angebot, die Dezimalstellen und den Preis unter token_info zurück:

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

Marktkapitalisierung berechnen

Multipliziere den Preis mit dem an die Dezimalstellen angepassten Angebot:

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;

Um alle fungiblen Token in einer Wallet einschließlich Guthaben und Preisen mit einem einzigen Aufruf aufzulisten, verwende getAssetsByOwner oder searchAssets mit tokenType: "fungible". Unter Erweiterung für fungible Token erfährst du, wie tokenType, Guthaben, Token-2022-Erweiterungen und Preisdaten in der response dargestellt werden.

Best Practices

Verwende Paginierung für Methoden, die große Ergebnismengen zurückgeben. Weitere Informationen findest du im Leitfaden zur Paginierung.
Bevorzuge DAS-Methoden (getAsset, getAssetsByOwner, getTokenAccounts), wenn du Metadaten oder USD-Preise benötigst. Verwende standardmäßige RPC-Methoden für unverarbeitete On-Chain-Guthaben und das Angebot.
Behandle Fehler zuverlässig mit try/catch-Blöcken und Wiederholungsversuchen.
Speichere responses bei Bedarf zwischen, um API-Aufrufe zu reduzieren.

Nächste Schritte

Fungible Token Extension

So gibt DAS fungible Token, Token-2022-Erweiterungen und Preise zurück.

Get Assets (NFTs)

Rufe NFTs, komprimierte NFTs, Editionen und Nachweise ab.

DAS API reference

Vollständige Schemas für jede DAS-Methode.

Erste Schritte

Streaming von Daten und Event-Überwachung

Daten-APIs und RPCs

Trading

Transaktionen senden

Wallet-as-a-Service

Datenschutz

Ressourcen

So rufst du Solana SPL Token ab: vollständiger API-Leitfaden

Übersicht

Wann du diese Methoden verwenden solltest

Guthaben eines Kontos für Token

API Reference

Konten für Token nach Besitzer

API Reference

Konten für Token nach Mint

API Reference

Gesamtangebot eines Token

API Reference

Größte Inhaber eines Token

API Reference

Konten für Token mit der DAS API

API Reference

Metadaten und Preis eines Token mit der DAS API

API Reference

Marktkapitalisierung berechnen

Best Practices

Nächste Schritte

Fungible Token Extension

Get Assets (NFTs)

DAS API reference

​Übersicht

​Wann du diese Methoden verwenden solltest

​Guthaben eines Kontos für Token

API Reference

​Konten für Token nach Besitzer

API Reference

​Konten für Token nach Mint

API Reference

​Gesamtangebot eines Token

API Reference

​Größte Inhaber eines Token

API Reference

​Konten für Token mit der DAS API

API Reference

​Metadaten und Preis eines Token mit der DAS API

API Reference

​Marktkapitalisierung berechnen

​Best Practices

​Nächste Schritte

Fungible Token Extension

Get Assets (NFTs)

DAS API reference

Übersicht

Wann du diese Methoden verwenden solltest

Guthaben eines Kontos für Token

Konten für Token nach Besitzer

Konten für Token nach Mint

Gesamtangebot eines Token

Größte Inhaber eines Token

Konten für Token mit der DAS API

Metadaten und Preis eines Token mit der DAS API

Marktkapitalisierung berechnen

Best Practices

Nächste Schritte