Parametreler
Token hesabının açık anahtarı (base-58 kodlu)
Şunları içeren yapılandırma nesnesi:Onay seviyesi (processed, confirmed, finalized)
Yanıt
Şunları içeren nesne:Ham token miktarı (dize olarak)
Token mint’i için yapılandırılmış ondalık basamak sayısı
Ondalık basamakları hesaba katan float olarak token miktarı
Ondalık basamakları hesaba katan dize olarak token miktarı
Kod Örnekleri
Temel İstek
curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getTokenAccountBalance",
"params": [
"4vJ9JU1bJJE96FWSJKvHsmmFADCg4gpZQff4P3bkLZj"
]
}'
web3.js Kullanımı
import { Connection, PublicKey } from '@solana/web3.js';
const connection = new Connection('https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY');
// Get token account balance
const tokenAccount = new PublicKey('4vJ9JU1bJJE96FWSJKvHsmmFADCg4gpZQff4P3bkLZj');
const balance = await connection.getTokenAccountBalance(tokenAccount);
console.log('Token balance:', balance);
// Get token account balance with analysis
async function getTokenAccountBalanceWithAnalysis(
tokenAccount: PublicKey,
config?: { commitment?: string }
) {
const balance = await connection.getTokenAccountBalance(tokenAccount, config);
return {
balance,
analysis: {
rawAmount: balance.value.amount,
uiAmount: balance.value.uiAmount,
uiAmountString: balance.value.uiAmountString,
decimals: balance.value.decimals,
metadata: {
timestamp: Date.now(),
commitment: config?.commitment
}
}
};
}
Notlar
- Bir token hesabının token bakiyesini döndürür
- Bakiye hem ham hem de kullanıcı dostu formatlarda döndürülür
- Mevcut durumdan okuduğu için yanıt anında gelir
- Bakiye, token transferleri ve diğer işlemlerle değişebilir
- Hesap geçerli bir token hesabı olmalıdır
En İyi Uygulamalar
- İhtiyacınıza göre uygun onay seviyesini kullanın
- RPC yükünü azaltmak için uygun durumlarda sonuçları önbelleğe alın
- Token bakiyelerindeki değişiklikleri izleyin
- Gerçek zamanlı güncellemeler için WebSocket aboneliği kullanmayı düşünün
- Ağ hatalarını yönetin ve gerektiğinde yeniden deneyin
Yaygın Hatalar
| Kod | Mesaj | Çözüm |
|---|
| -32601 | Method not found | Bir Solana RPC düğümüne bağlı olduğunuzu doğrulayın |
| -32602 | Invalid params | Token hesabı açık anahtarını kontrol edin |
| -32007 | Token account not found | Token hesabının var olduğunu doğrulayın |
| -32008 | Invalid token account | Hesabın geçerli bir token hesabı olduğunu doğrulayın |