Solana SPLトークンを取得する方法：完全なAPIガイド

概要

このガイドは、Solanaでのファンジブルトークンの読み取りをカバーします：アカウントの残高、オーナーまたはミントによるトークンアカウント、総供給量、最大ホルダー、およびDASファンジブルトークン拡張。Heliusは標準のSolana RPCトークンメソッドと、メタデータやUSD価格を追加するDASメソッドの両方を公開しています。 NFT、圧縮NFT、エディション、証明については、アセット取得ガイドを参照してください。このページはファンジブル（SPLとToken-2022）トークンに焦点を当てています。

これを使用するタイミング

このページの方法を使用するのは次のような場合です：

単一トークンアカウントの残高を読み取る場合
ウォレットが保持するすべてのトークンアカウントをリストアップする場合
特定のミントを保持するすべてのアカウントを見つける場合
トークンの総供給量または最大ホルダーを確認する場合
残高とともにトークンのメタデータとUSD価格を取得する場合

トークンアカウント残高

標準RPCを使用して特定のトークンアカウントの残高を取得します：

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リファレンス

getTokenAccountBalance

所有者別トークンアカウント

ウォレットによって所有されるすべてのトークンアカウントをリストします：

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リファレンス

getTokenAccountsByOwner

ミント別トークンアカウント

特定のトークンを保持するすべてのアカウントをリストします：

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リファレンス

getTokenAccountsByOwner

すべての所有者（単一の所有者に限定しない）にわたってミントを保持するすべてのアカウントを見つけるには、以下で説明するDAS getTokenAccountsメソッドを使用します。

トークン供給

トークンの総供給量を確認します：

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リファレンス

getTokenSupply

最大トークンホルダー

トークンを保持している最大のアカウントを特定します：

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リファレンス

getTokenLargestAccounts

ミントに対して最大20のアカウントを返します：

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

DAS APIによるトークンアカウント

DAS getTokenAccountsメソッドは、ミントまたは所有者によるトークンアカウントを、残高を含む単一のページネーションされた呼び出しで返します。getTokenAccountsByOwnerとは異なり、ミントのすべての所有者にまたがるすべてのアカウントをリストするにはmintのみでクエリ可能です。

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リファレンス

getTokenAccounts

ページネーションされています；それぞれのエントリにはアカウント、ミント、所有者、残高が含まれます：

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

DAS APIによるトークンメタデータと価格

トークンメタデータとUSD価格を取得するには、showFungibleを有効にしてDAS getAssetメソッドを呼び出します。検証済みトークンの価格はtoken_info.price_infoで返されます。

getAssetからの価格データは最大600秒キャッシュされるため、最大10分前の情報です。

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リファレンス

getAsset

レスポンスには、token_infoの下に供給、桁数、価格が返されます：

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

時価総額を計算

価格に10進数調整された供給を掛けます：

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;

1回の呼び出しでウォレット内のすべてのファンジブルトークン（残高と価格を含む）をリストするには、getAssetsByOwnerまたはsearchAssetsをtokenType: "fungible"と一緒に使用します。レスポンスでtokenType、残高、Token-2022拡張機能、価格データがどのように表示されるかについてはファンジブルトークン拡張を参照してください。

ベストプラクティス

大量の結果セットを返すメソッドに対してはページネーションを使用します。ページネーションガイドを参照してください。
メタデータやUSD価格が必要な場合はDASメソッド（getAsset、getAssetsByOwner、getTokenAccounts）を優先します。生のオンチェーン残高や供給のためには標準RPCメソッドを使用します。
エラーをtry/catchブロックとリトライで丁寧に処理します。
適切な場合はレスポンスをキャッシュし、APIコールを減らします。

次のステップ

ファンジブルトークン拡張

DASがファンジブルトークン、Token-2022拡張、価格を返す方法。

アセット取得（NFTs）

NFTs、圧縮NFTs、エディション、証明を取得。

DAS APIリファレンス

すべてのDASメソッドの完全なスキーマ。

はじめに

データストリーミングとイベントリスニング

データ API & RPC

トレーディング

トランザクションの送信

ウォレット・アズ・ア・サービス

ガイド

リソース

Solana SPLトークンを取得する方法：完全なAPIガイド

概要

これを使用するタイミング

トークンアカウント残高

APIリファレンス

所有者別トークンアカウント

APIリファレンス

ミント別トークンアカウント

APIリファレンス

トークン供給

APIリファレンス

最大トークンホルダー

APIリファレンス

DAS APIによるトークンアカウント

APIリファレンス

DAS APIによるトークンメタデータと価格

APIリファレンス

時価総額を計算

ベストプラクティス

次のステップ

ファンジブルトークン拡張

アセット取得（NFTs）

DAS APIリファレンス

​概要

​これを使用するタイミング

​トークンアカウント残高

APIリファレンス

​所有者別トークンアカウント

APIリファレンス

​ミント別トークンアカウント

APIリファレンス

​トークン供給

APIリファレンス

​最大トークンホルダー

APIリファレンス

​DAS APIによるトークンアカウント

APIリファレンス

​DAS APIによるトークンメタデータと価格

APIリファレンス

​時価総額を計算

​ベストプラクティス

​次のステップ

ファンジブルトークン拡張

アセット取得（NFTs）

DAS APIリファレンス

概要

これを使用するタイミング

トークンアカウント残高

所有者別トークンアカウント

ミント別トークンアカウント

トークン供給

最大トークンホルダー

DAS APIによるトークンアカウント

DAS APIによるトークンメタデータと価格

時価総額を計算

ベストプラクティス

次のステップ