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

# Get your wallet balance

Returns your app's own FLY wallet balance — the wallet that
[`POST /issue_reward`](/api-reference/rewards/issue) draws from — alongside its
USD equivalent. Check it before issuing rewards to make sure the wallet is
funded.

Auth: API key in `X-API-Key`. The key must carry the `read:balance` scope.

## Example

```bash theme={null}
curl "https://api.staging.blackbird.xyz/flynet/v1/balance" \
  -H "X-API-Key: $API_KEY"
```

## Response

```json theme={null}
{
  "id": "3f1c6d8e-0f12-4a5b-8c9d-1e2f3a4b5c6d",
  "object": "account_balance",
  "owner_id": "2c8f0e5a-1d4b-4c9e-9f2a-7b3c6d8e0f12",
  "owner_type": "flynet_merchant",
  "balance": { "value": "2500000000000000000", "currency": "fly" },
  "balance_usd": { "value": 250, "currency": "usd" }
}
```

<Note>
  **Tasting note** — `balance.value` is a big-integer string in FLY's smallest
  unit. Parse it with a big-integer type, never a float, or you will silently
  lose precision. `balance_usd.value` is integer cents (`250` = \$2.50).
</Note>

| Field         | Type   | Notes                                                                   |
| ------------- | ------ | ----------------------------------------------------------------------- |
| `balance`     | object | FLY balance: `value` (smallest-unit big-integer string) and `currency`. |
| `balance_usd` | object | USD equivalent: `value` (integer cents) and `currency`.                 |
| `owner_id`    | UUID   | The owning wallet — your `flynet_merchant_id`.                          |
| `owner_type`  | string | `flynet_merchant` for an app wallet.                                    |