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

# Manage asset balances

> Query wallet balances across currencies and review the unified transaction history.

[Stablecoin Account API Publisher Disclaimer](/stablecoin-account/v1.6/guide/stablecoin-account-api-publisher-disclaimer)

Every currency you hold — crypto or fiat — lives in its own wallet with a `balance_id`. Wallets are created automatically the first time you receive a currency; there is no create-wallet endpoint. Use the Assets endpoints to read balances and reconcile the transactions behind them.

## List all balances

Call [List Assets](/stablecoin-account/v1.6/api-reference/list-assets) to page through every wallet on the account. Filter by `balance_currency` or `balance_status` (`Pending`, `Active`, `Closed`) if you only need a subset.

```bash theme={null}
curl "https://api-sandbox.uqpaytech.com/api/v1/ramp/asset?page_size=10&page_num=1&balance_status=Active" \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
```

**Response (abbreviated):**

```json theme={null}
{
  "code": 200,
  "message": "Success",
  "data": {
    "data": [
      {
        "balance_id": "5e56e5de-f354-4570-8cbc-cc134d7a5b75",
        "balance_currency": "USDC",
        "balance_status": "Active",
        "available_balance": "9100",
        "margin_balance": "0",
        "frozen_balance": "0",
        "create_time": "2025-06-30 17:03:06 +08:00",
        "last_trade_time": "2025-10-24 17:51:24 +08:00"
      }
    ],
    "total_pages": 1,
    "total_items": 1
  }
}
```

Only `available_balance` can be spent. Funds tied up by in-flight withdrawals, conversions, or risk review sit in `frozen_balance` until the order settles.

## Retrieve one balance

When you already know the currency, fetch it directly with [Retrieve Asset](/stablecoin-account/v1.6/api-reference/retrieve-asset):

```bash theme={null}
curl "https://api-sandbox.uqpaytech.com/api/v1/ramp/asset/USDC" \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
```

The response carries a single asset object with the same fields as the list.

## Review transaction history

[List Asset Transactions](/stablecoin-account/v1.6/api-reference/list-asset-transactions) returns one unified ledger covering all order types — deposits, withdrawals, conversions (`Sell` / `Buy` / `Swap`), and transfers — so you can reconcile balances without calling each resource's list endpoint separately.

```bash theme={null}
curl "https://api-sandbox.uqpaytech.com/api/v1/ramp/asset/transactions?page_size=10&page_num=1&order_type=WITHDRAW&order_status=SUCCESS" \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
```

Useful filters:

| Parameter                 | Values                                                                      |
| ------------------------- | --------------------------------------------------------------------------- |
| `order_type`              | `DEPOSIT`, `WITHDRAW`, `SELL`, `BUY`, `SWAP`, `TRANSFER_IN`, `TRANSFER_OUT` |
| `order_status`            | `SUBMIT_FAILED`, `FAILED`, `PENDING`, `SUCCESS`, `SUBMITTED`                |
| `balance_currency`        | Wallet currency, for example `USDT`                                         |
| `order_id`                | A long `order_id` or `short_order_id`                                       |
| `start_time` / `end_time` | ISO 8601 bounds on `create_time` (exclusive)                                |

Each transaction reports the sold side (`sell_currency` / `sell_amount`), the bought side for conversions (`buy_currency` / `buy_amount`), and the fees charged (`network_fee`, `processing_fee`).

<Tip>
  For drill-down details beyond the ledger row — for example a withdrawal's destination address or transaction hash — retrieve the order from its own resource using the `order_id`: [Retrieve Deposit](/stablecoin-account/v1.6/api-reference/retrieve-deposit), [Retrieve Withdraw](/stablecoin-account/v1.6/api-reference/retrieve-withdraw), [Retrieve Conversion](/stablecoin-account/v1.6/api-reference/retrieve-conversion), or [Retrieve Transfer](/stablecoin-account/v1.6/api-reference/retrieve-transfer).
</Tip>

## Related

* [List Assets API](/stablecoin-account/v1.6/api-reference/list-assets)
* [List Asset Transactions API](/stablecoin-account/v1.6/api-reference/list-asset-transactions)
* [Core concepts](/stablecoin-account/v1.6/guide/core-concepts) — order types and statuses
* [Supported assets and networks](/stablecoin-account/v1.6/guide/supported-assets-and-networks)