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

# Wallets & Balances

> How PIK wallets work, which currencies support inbound, how to fund non-AUD balances, and how to retrieve and move funds.

Every PIK account has a multi-currency wallet that holds balances in multiple currencies simultaneously.

### Currency Capability Matrix

| Currency         | Receive Inbound                               | Hold Balance | FX Convert  | On/Off Ramp          | Payout      |
| :--------------- | :-------------------------------------------- | :----------- | :---------- | :------------------- | :---------- |
| AUD              | ✅ Via Virtual Account Number (BSB)            | ✅            | ✅           | ✅ Off-ramp to crypto | ✅           |
| USDT             | ✅ Via dedicated crypto wallet address         | ✅            | ✅           | ✅ On-ramp to fiat    | ✅           |
| USDC             | ✅ Via dedicated crypto wallet address         | ✅            | ✅           | ✅ On-ramp to fiat    | ✅           |
| USD              | ✅ Via virtual bank account (contact PIK)      | ✅            | ✅           | ✅                    | ✅           |
| EUR              | ✅ Via virtual bank account (contact PIK)      | ✅            | ✅           | ❌                    | ✅           |
| GBP              | ✅ Via virtual bank account (contact PIK)      | ✅            | ✅           | ❌                    | ✅           |
| HKD              | ✅ Via virtual bank account (contact PIK)      | ✅            | ✅           | ❌                    | ✅           |
| SGD              | ✅ Via virtual bank account (contact PIK)      | ✅            | ✅           | ❌                    | ✅           |
| JPY              | Contact [hi@pik.global](mailto:hi@pik.global) | ✅            | ✅           | ❌                    | ✅           |
| Other currencies | Contact [hi@pik.global](mailto:hi@pik.global) | Contact PIK  | Contact PIK | ❌                    | Contact PIK |

### AUD Currencies

In addition to AUD Virtual Account Numbers, PIK supports virtual bank accounts for additional currencies. These allow connected accounts to receive local fiat transfers directly — without conversion or SWIFT.

| Currency | Local Account Type              | Settlement Rail     | Inbound Supported?                            |
| :------- | :------------------------------ | :------------------ | :-------------------------------------------- |
| AUD      | BSB + account number            | NPP / Bank transfer | ✅ Live                                        |
| USD      | Routing number + account number | ACH                 | Contact [hi@pik.global](mailto:hi@pik.global) |
| EUR      | IBAN                            | SEPA                | Contact [hi@pik.global](mailto:hi@pik.global) |
| GBP      | Sort code + account number      | Faster Payments     | Contact [hi@pik.global](mailto:hi@pik.global) |
| HKD      | Bank account number             | FPS                 | Contact [hi@pik.global](mailto:hi@pik.global) |
| SGD      | Bank account number             | FAST                | Contact [hi@pik.global](mailto:hi@pik.global) |

> Contact [hi@pik.global](mailto:hi@pik.global) to enable virtual bank accounts in non-AUD currencies for your platform's connected accounts.

### How Wallets Work

```mermaid theme={null}
graph TD
    A["Inbound AUD<br/>Bank Transfer"] -->|Credits| B["AUD Balance"]
    C["Inbound USDT<br/>On-chain"] -->|Credits| D["USDT Balance"]
    E["Inbound USDC<br/>On-chain"] -->|Credits| F["USDC Balance"]
    B -->|FX Conversion| G["Target Currency<br/>Balance"]
    D -->|FX Conversion| G
    F -->|FX Conversion| G
    B -->|Payout| H["External Bank<br/>Account"]
    D -->|Payout| I["External Wallet<br/>Address"]
    F -->|Payout| I
    G -->|Payout| H
    G -->|Payout| I
```

* Inbound AUD bank transfer → credits AUD balance
* Inbound USDT on-chain → credits USDT balance
* Inbound USDC on-chain → credits USDC balance
* FX conversion → debits source currency, credits target currency
* Payout → debits the relevant currency balance

Funds never leave PIK custody until a payout is executed to an external bank account or wallet address.

### How to Fund a USD, HKD, or SGD Balance

**Path 1 — Receive AUD then convert:**

```text theme={null}
Receive AUD via VAN → FX convert AUD to USD / HKD / SGD
```

**Path 2 — Receive crypto then convert:**

```text theme={null}
Receive USDT or USDC via wallet address → FX convert to USD / HKD / SGD
```

### On-Ramp and Off-Ramp

| Direction | What It Does                       | Example                                     |
| :-------- | :--------------------------------- | :------------------------------------------ |
| On-ramp   | Convert USDT or USDC to AUD or USD | Receive crypto, hold or pay out in fiat     |
| Off-ramp  | Convert AUD or USD to USDT or USDC | Receive AUD, convert to USDT for withdrawal |

### Third-Party Fund-In

Any third party can send funds to a connected account's VAN or wallet address without needing a PIK account.

### Retrieve Wallet Balances

http

```text theme={null}
GET /api/v1/accounts/{connected-account-id}/wallet/balances
Authorization: Bearer YOUR_PLATFORM_API_KEY
x-on-behalf-of: {connected-account-id}
```

| Field     | Description                                        |
| :-------- | :------------------------------------------------- |
| currency  | Currency code e.g. AUD, USDT, USDC                 |
| available | Funds available for conversion or payout right now |
| pending   | Inbound funds received but not yet settled         |

### Move Funds Between Wallets

http

```text theme={null}
POST /api/v1/transfers
```

Transfers cannot exceed the available balance — attempting to do so returns a 402 INSUFFICIENT\_BALANCE error.