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

# Get Balance

> Retrieve your current balance and pending balance

## Overview

Returns your current available balance and pending balance (deposits requiring verification before becoming available).

## Authentication

<ParamField header="X-API-Key" type="string" required>
  Your site API key
</ParamField>

## Rate Limit

**2 requests per minute**

## Response

<ResponseField name="balance" type="integer">
  Your current available balance in cents
</ResponseField>

<ResponseField name="pending_balance" type="integer">
  Pending balance from deposits requiring verification in cents (not yet available for use)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.liquid.tf/api/dev/get_balance" \
    -H "X-API-Key: YOUR_SITE_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.liquid.tf/api/dev/get_balance', {
    headers: {
      'X-API-Key': 'YOUR_SITE_API_KEY'
    }
  });

  const data = await response.json();
  console.log(`Balance: $${data.balance / 100}`);
  console.log(`Pending: $${data.pending_balance / 100}`);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.liquid.tf/api/dev/get_balance',
      headers={'X-API-Key': 'YOUR_SITE_API_KEY'}
  )

  data = response.json()
  print(f"Balance: ${data['balance'] / 100:.2f}")
  print(f"Pending: ${data['pending_balance'] / 100:.2f}")
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "balance": 25000,
    "pending_balance": 5000
  }
  ```
</ResponseExample>

## Understanding Balance vs Pending Balance

**balance**: Funds available for immediate use

* Can be withdrawn to your bank account
* Can be used to purchase items
* Immediately spendable on the marketplace

**pending\_balance**: Deposits requiring verification

* Bank transfers that haven't cleared yet
* Payment methods pending verification
* Will become available balance after verification completes
* Cannot be withdrawn or spent until verified

## Use Cases

* Display current balance in your application
* Check if user has sufficient funds before purchase
* Monitor account funds for automated trading bots
* Track earnings from sales