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

# Get Merchant Balance

> Retrieve a merchant's current on-chain USDC balance

# Get Merchant Balance

Returns the merchant's current USDC balance in their on-chain proxy contract. This is the amount available for withdrawal or settlement.

## Path Parameters

<ParamField path="id" type="string" required>
  The merchant ID (format: `mer_*`).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.stablegenius.co/v1/merchants/mer_abc123/balance \
    -H "Authorization: Bearer sk_test_abc123"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "object": "balance",
    "merchant_id": "mer_abc123",
    "available": 142.55,
    "pending_settlement": 0.00,
    "currency": "usd",
    "payment_address": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
    "chain": "base",
    "last_updated": "2026-04-01T20:15:00Z"
  }
  ```
</ResponseExample>

<Note>
  The `available` balance reflects confirmed on-chain USDC. It updates within seconds of a payment being confirmed. The `pending_settlement` amount represents funds that are in the process of being withdrawn to the merchant's bank account.
</Note>