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

# Get Balance

> Get the current USDC wallet balance.

Returns the current USDC balance, spending totals, and wallet address for the project linked to the authenticated API token. All monetary values are in micro-USDC (1 USDC = 1,000,000).

<Note>
  Requires a bearer token with the `read` permission.
</Note>

## Request

This endpoint takes no query parameters or request body.

## Response

<ResponseField name="project_id" type="string" required>
  Unique project identifier.
</ResponseField>

<ResponseField name="currency" type="string" required>
  Always `"usdc"`.
</ResponseField>

<ResponseField name="available" type="integer" required>
  Available USDC balance in micro-USDC.
</ResponseField>

<ResponseField name="pending" type="integer" required>
  Pending USDC balance in micro-USDC. Funds in transit that are not yet available.
</ResponseField>

<ResponseField name="total_funded" type="integer" required>
  Cumulative USDC funded into this project in micro-USDC.
</ResponseField>

<ResponseField name="total_spent" type="integer" required>
  Cumulative USDC spent from this project in micro-USDC.
</ResponseField>

<ResponseField name="wallet_address" type="string | null" required>
  Bridge wallet address on Base for receiving USDC deposits. `null` if no wallet has been created yet.
</ResponseField>

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.unwall.xyz/v1/balance \
    -H "Authorization: Bearer aw_live_xxxxxxxxxxxx"
  ```

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

  resp = requests.get(
      "https://api.unwall.xyz/v1/balance",
      headers={"Authorization": "Bearer aw_live_xxxxxxxxxxxx"},
  )
  balance = resp.json()
  usdc = balance["available"] / 1_000_000
  print(f"Balance: {usdc:.2f} USDC")
  ```

  ```typescript TypeScript theme={null}
  const resp = await fetch("https://api.unwall.xyz/v1/balance", {
    headers: {
      Authorization: "Bearer aw_live_xxxxxxxxxxxx",
    },
  });
  const balance = await resp.json();
  console.log(`Balance: ${(balance.available / 1_000_000).toFixed(2)} USDC`);
  ```
</CodeGroup>

```json Response (200 OK) theme={null}
{
  "project_id": "proj_abc123",
  "currency": "usdc",
  "available": 5000000,
  "pending": 0,
  "total_funded": 5000000,
  "total_spent": 0,
  "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28"
}
```