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

# Get Wallet

> Get your Fyatu business wallet balance and currency details. GET /account/wallet.

## Overview

Retrieve your business wallet information including:

* **Balance**: Available, hold, and total amounts in USD
* **Deposit Addresses**: TRC20 and ERC20 addresses for receiving crypto deposits
* **Withdrawal Address**: Your configured USDT withdrawal destination

## Response Details

### Balance Object

| Field       | Type   | Description                                     |
| ----------- | ------ | ----------------------------------------------- |
| `available` | number | Balance available for use (total - hold)        |
| `hold`      | number | Amount currently on hold for pending operations |
| `total`     | number | Total account balance                           |
| `currency`  | string | Always `USD`                                    |

### Deposit Addresses

The deposit object contains:

* **TRC20 Address**: For deposits on TRON network
* **ERC20 Address**: For deposits on ETH, BSC, Polygon, Arbitrum, Avalanche networks

Both address types accept USDT and USDC.

<Note>
  If you don't have a deposit address yet, use the [Generate Deposit Address](/v3/api-reference/account/deposit-address) endpoint to create one.
</Note>

### Withdrawal Address

Returns `null` if no withdrawal address is configured. Otherwise includes:

| Field        | Type     | Description                                     |
| ------------ | -------- | ----------------------------------------------- |
| `address`    | string   | The USDT wallet address                         |
| `network`    | string   | `TRC20` or `ERC20`                              |
| `isVerified` | boolean  | Whether the address is verified for withdrawals |
| `addedAt`    | datetime | When the address was registered                 |

## Example Usage

```javascript theme={null}
const response = await fetch('https://api.fyatu.com/api/v3/account/wallet', {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
});

const { data } = await response.json();

console.log(`Available: $${data.balance.available}`);
console.log(`TRC20 Address: ${data.deposit.addresses.TRC20?.address}`);
```


## OpenAPI

````yaml v3/openapi.json GET /account/wallet
openapi: 3.1.0
info:
  title: FYATU API v3
  description: >-
    FYATU API v3 with JWT authentication for Collections, Payouts, and Card
    Issuing.
  version: 3.0.0
  contact:
    name: FYATU Support
    url: https://fyatu.com
    email: support@fyatu.com
servers:
  - url: https://api.fyatu.com/api/v3
    description: Production
security: []
tags:
  - name: Authentication
    description: JWT token management endpoints
  - name: Account
    description: Business account, wallet, and address management
  - name: Collections
    description: Accept payments from customers via checkout sessions
  - name: Refunds
    description: Issue refunds for completed collections
  - name: Payouts
    description: Send money to Fyatu account holders
  - name: Cardholders
    description: Cardholder management for card issuing programs
  - name: Cards
    description: Issue, fund, freeze, and manage virtual cards
  - name: Webhooks
    description: Webhook configuration and management
paths:
  /account/wallet:
    get:
      tags:
        - Account
      summary: Get Wallet
      description: >-
        Retrieve wallet balances, deposit addresses, and withdrawal address
        information.
      operationId: getWallet
      responses:
        '200':
          description: Wallet information retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WalletResponse'
              example:
                success: true
                status: 200
                message: Wallet information retrieved successfully
                data:
                  balance:
                    available: 1500
                    hold: 100
                    total: 1600
                    currency: USD
                  deposit:
                    addresses:
                      TRC20:
                        address: TRC20_ADDRESS_HERE
                        networks:
                          - TRON
                        currencies:
                          - USDT
                          - USDC
                      ERC20:
                        address: 0xERC20_ADDRESS_HERE
                        networks:
                          - ETH
                          - BSC
                          - POLYGON
                          - ARBITRUM
                          - AVALANCHE
                        currencies:
                          - USDT
                          - USDC
                    supportedCurrencies:
                      - USDT
                      - USDC
                    supportedNetworks:
                      - TRON
                      - ETH
                      - BSC
                      - POLYGON
                      - ARBITRUM
                      - AVALANCHE
                  withdrawal:
                    address: TYourTronAddressHere1234567890123
                    currency: USDT
                    network: TRON
                    isVerified: true
                    addedAt: '2026-01-05T10:30:00+00:00'
                meta:
                  requestId: req_abc123def456
                  timestamp: '2026-01-05T10:30:00+00:00'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
        - BearerAuth: []
components:
  schemas:
    WalletResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        status:
          type: integer
          example: 200
        message:
          type: string
        data:
          $ref: '#/components/schemas/WalletData'
        meta:
          $ref: '#/components/schemas/Meta'
    WalletData:
      type: object
      properties:
        balance:
          type: object
          properties:
            available:
              type: number
              description: Available balance for use
            hold:
              type: number
              description: Balance on hold
            total:
              type: number
              description: Total balance including hold
            currency:
              type: string
              enum:
                - USD
              description: Account currency
        deposit:
          type: object
          properties:
            addresses:
              type: object
              description: Map of address type to address info
            supportedCurrencies:
              type: array
              items:
                type: string
            supportedNetworks:
              type: array
              items:
                type: string
        withdrawal:
          type: object
          nullable: true
          properties:
            address:
              type: string
            network:
              type: string
            currency:
              type: string
            isVerified:
              type: boolean
            addedAt:
              type: string
              format: date-time
    Meta:
      type: object
      properties:
        requestId:
          type: string
          description: Unique request ID for tracking
          example: req_abc123def456
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp of the response
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        status:
          type: integer
          example: 401
        message:
          type: string
          example: Invalid credentials
        error:
          $ref: '#/components/schemas/Error'
        meta:
          $ref: '#/components/schemas/Meta'
    Error:
      type: object
      properties:
        code:
          type: string
          description: Error code for programmatic handling
          example: AUTH_INVALID_CREDENTIALS
        details:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
          description: Validation error details (for VALIDATION_ERROR)
    ValidationError:
      type: object
      properties:
        field:
          type: string
          description: Field that failed validation
          example: appId
        message:
          type: string
          description: Validation error message
          example: AppId is required
  responses:
    Unauthorized:
      description: Authentication required or token invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            status: 401
            message: Unable to identify business
            error:
              code: AUTH_TOKEN_INVALID
            meta:
              requestId: req_abc123
              timestamp: '2026-01-05T10:30:00+00:00'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            status: 404
            message: Wallet not found
            error:
              code: RESOURCE_NOT_FOUND
            meta:
              requestId: req_abc123
              timestamp: '2026-01-05T10:30:00+00:00'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT access token obtained from /auth/token

````