> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getTokenAccountBalance

> Bir hesabın token bakiyesini döndürür

## Parametreler

<ResponseField name="pubkey" type="string" required>
  Token hesabının açık anahtarı (base-58 kodlu)
</ResponseField>

<ResponseField name="config" type="object" optional>
  Şunları içeren yapılandırma nesnesi:

  <ResponseField name="commitment" type="string" optional>
    Onay seviyesi (processed, confirmed, finalized)
  </ResponseField>
</ResponseField>

## Yanıt

<ResponseField name="result" type="object">
  Şunları içeren nesne:

  <ResponseField name="context" type="object">
    <ResponseField name="slot" type="number">
      İsteğin işlendiği slot
    </ResponseField>
  </ResponseField>

  <ResponseField name="value" type="object">
    <ResponseField name="amount" type="string">
      Ham token miktarı (dize olarak)
    </ResponseField>

    <ResponseField name="decimals" type="number">
      Token mint'i için yapılandırılmış ondalık basamak sayısı
    </ResponseField>

    <ResponseField name="uiAmount" type="number" optional>
      Ondalık basamakları hesaba katan float olarak token miktarı
    </ResponseField>

    <ResponseField name="uiAmountString" type="string" optional>
      Ondalık basamakları hesaba katan dize olarak token miktarı
    </ResponseField>
  </ResponseField>
</ResponseField>

## Kod Örnekleri

### Temel İstek

```bash theme={null}
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ı

```typescript theme={null}
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

1. Bir token hesabının token bakiyesini döndürür
2. Bakiye hem ham hem de kullanıcı dostu formatlarda döndürülür
3. Mevcut durumdan okuduğu için yanıt anında gelir
4. Bakiye, token transferleri ve diğer işlemlerle değişebilir
5. Hesap geçerli bir token hesabı olmalıdır

## En İyi Uygulamalar

1. İhtiyacınıza göre uygun onay seviyesini kullanın
2. RPC yükünü azaltmak için uygun durumlarda sonuçları önbelleğe alın
3. Token bakiyelerindeki değişiklikleri izleyin
4. Gerçek zamanlı güncellemeler için WebSocket aboneliği kullanmayı düşünün
5. 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 |