Cara Mendapatkan Token SPL Solana: Panduan API Lengkap

Ringkasan

Panduan ini membahas cara membaca token yang dapat dipertukarkan di Solana: saldo akun, akun token berdasarkan pemilik atau mint, total pasokan, pemegang terbesar, dan ekstensi token yang dapat dipertukarkan DAS. Helius menyediakan metode token RPC Solana standar serta metode DAS yang menambahkan metadata dan harga dalam USD. Untuk NFT, NFT terkompresi, edisi, dan bukti, lihat panduan Mendapatkan Aset. Halaman ini berfokus pada token yang dapat dipertukarkan (SPL dan Token-2022).

Kapan menggunakannya

Gunakan metode di halaman ini saat Anda ingin:

Membaca saldo satu akun token
Mencantumkan setiap akun token yang dimiliki dompet
Menemukan semua akun yang menyimpan mint tertentu
Memeriksa total pasokan token atau pemegang terbesarnya
Mengambil metadata token dan harga dalam USD beserta saldo

Saldo akun token

Dapatkan saldo akun token tertentu menggunakan RPC standar:

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

Akun token berdasarkan pemilik

Cantumkan semua akun token yang dimiliki oleh sebuah dompet:

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

Akun token berdasarkan mint

Cantumkan semua akun yang menyimpan token tertentu:

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

Untuk menemukan setiap akun yang menyimpan sebuah mint di seluruh pemilik (bukan hanya satu pemilik), gunakan metode DAS getTokenAccounts yang dijelaskan di bawah ini.

Pasokan token

Periksa total pasokan sebuah 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

Pemegang token terbesar

Identifikasi akun terbesar yang menyimpan sebuah 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: 'getTokenLargestAccounts',
    params: [
      'he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A'
    ]
  })
});
const data = await response.json();
console.log(data);

API Reference

getTokenLargestAccounts

Mengembalikan hingga 20 akun terbesar untuk mint tersebut:

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

Akun token dengan DAS API

Metode DAS getTokenAccounts mengembalikan akun token berdasarkan mint atau pemilik, termasuk saldo, dalam satu panggilan dengan paginasi. Tidak seperti getTokenAccountsByOwner, Anda dapat melakukan kueri hanya berdasarkan mint untuk mencantumkan setiap akun yang menyimpan sebuah token di seluruh pemilik.

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

Menggunakan paginasi; setiap entri mencakup akun, mint, pemilik, dan saldo:

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

Metadata dan harga token dengan DAS API

Untuk mendapatkan metadata token dan harga dalam USD, panggil metode DAS getAsset dengan mengaktifkan showFungible. Harga untuk token terverifikasi dikembalikan dalam token_info.price_info.

Data harga dari getAsset disimpan dalam cache hingga 600 detik, sehingga data tersebut mungkin sudah berusia hingga 10 menit.

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

Respons mengembalikan pasokan, jumlah desimal, dan harga dalam token_info:

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

Menghitung kapitalisasi pasar

Kalikan harga dengan pasokan yang telah disesuaikan berdasarkan desimal:

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;

Untuk mencantumkan setiap token yang dapat dipertukarkan dalam dompet (beserta saldo dan harga) dalam satu panggilan, gunakan getAssetsByOwner atau searchAssets dengan tokenType: "fungible". Lihat ekstensi token yang dapat dipertukarkan untuk memahami bagaimana tokenType, saldo, ekstensi Token-2022, dan data harga muncul dalam respons.

Praktik terbaik

Gunakan paginasi untuk metode yang mengembalikan kumpulan hasil berukuran besar. Lihat panduan Paginasi.
Utamakan metode DAS (getAsset, getAssetsByOwner, getTokenAccounts) saat Anda memerlukan metadata atau harga dalam USD; gunakan metode RPC standar untuk saldo dan pasokan mentah di blockchain.
Tangani kesalahan dengan baik menggunakan blok try/catch dan percobaan ulang.
Simpan respons dalam cache jika sesuai untuk mengurangi panggilan API.

Langkah selanjutnya

Fungible Token Extension

Cara DAS mengembalikan token yang dapat dipertukarkan, ekstensi Token-2022, dan harga.

Get Assets (NFTs)

Ambil NFT, NFT terkompresi, edisi, dan bukti.

DAS API reference

Skema lengkap untuk setiap metode DAS.

Memulai

Streaming Data & Pemantauan Peristiwa

API Data & RPC

Perdagangan

Mengirim Transaksi

Dompet sebagai Layanan

Privasi

Sumber Daya

Cara Mendapatkan Token SPL Solana: Panduan API Lengkap

Ringkasan

Kapan menggunakannya

Saldo akun token

API Reference

Akun token berdasarkan pemilik

API Reference

Akun token berdasarkan mint

API Reference

Pasokan token

API Reference

Pemegang token terbesar

API Reference

Akun token dengan DAS API

API Reference

Metadata dan harga token dengan DAS API

API Reference

Menghitung kapitalisasi pasar

Praktik terbaik

Langkah selanjutnya

Fungible Token Extension

Get Assets (NFTs)

DAS API reference

​Ringkasan

​Kapan menggunakannya

​Saldo akun token

API Reference

​Akun token berdasarkan pemilik

API Reference

​Akun token berdasarkan mint

API Reference

​Pasokan token

API Reference

​Pemegang token terbesar

API Reference

​Akun token dengan DAS API

API Reference

​Metadata dan harga token dengan DAS API

API Reference

​Menghitung kapitalisasi pasar

​Praktik terbaik

​Langkah selanjutnya

Fungible Token Extension

Get Assets (NFTs)

DAS API reference

Ringkasan

Kapan menggunakannya

Saldo akun token

Akun token berdasarkan pemilik

Akun token berdasarkan mint

Pasokan token

Pemegang token terbesar

Akun token dengan DAS API

Metadata dan harga token dengan DAS API

Menghitung kapitalisasi pasar

Praktik terbaik

Langkah selanjutnya