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

# Balance and deposit

> Read settlement balance and sticky USDT TRC-20 deposit address.

# Balance and deposit

Scopes: `balance:read`, `deposit_address:read`.

## Balance

```http theme={null}
GET https://api.imbawallet.com/partner/balance?currency=USDT&network=TRON
Authorization: Bearer <access_token>
```

```json theme={null}
{
  "currency": "USDT",
  "network": "TRON",
  "ledger_balance": "15000.00",
  "available_balance": "14750.00",
  "reserved": "250.00",
  "pending_credit": "0.00",
  "as_of": "2026-07-10T09:15:30.123Z",
  "request_id": "019d0120-7b59-7eab-b837-a7af38ea3db2"
}
```

Spend against `available_balance`. `reserved` covers accepted but not yet settled operations. `pending_credit` is inbound USDT that is confirmed on-chain but not yet reflected in `ledger_balance`.

## Sticky deposit address

```http theme={null}
GET https://api.imbawallet.com/partner/deposit-address?currency=USDT&network=TRON
Authorization: Bearer <access_token>
```

```json theme={null}
{
  "currency": "USDT",
  "network": "TRON",
  "address": "TExamplePartnerDepositAddr111111",
  "memo": null,
  "confirmations_required": 19,
  "request_id": "019d0120-7b59-7eab-b837-a7af38ea3db2"
}
```

### Contract

| Rule                   | Meaning                                           |
| ---------------------- | ------------------------------------------------- |
| One address per tenant | For USDT / TRON                                   |
| Idempotent GET         | Every call returns the same `address`             |
| No rotation            | Idle time does not change the address             |
| Exclusive              | Never reused for another partner                  |
| Safe to hardcode       | Whitelist it in your treasury systems             |
| Change only via ops    | Compromised key / offboarding — IMBA notifies you |

Only **USDT TRC-20** is accepted. `confirmations_required` comes from network settings (default **19**). After confirmations, funds credit your settlement balance.

Do not send other tokens or networks to this address.