# Execute FX transfer between wallets

> 🔒 **Private label — [contact sales](mailto:sales@boyahq.com).** Requires a private-label entitlement on your API client.

Performs an internal fund transfer between two wallets with FX conversion. Auto-generates a reference if not provided.

Endpoint: POST /fx/transfer
Version: 2.0.0
Security: oauth2ClientCredentials

## Header parameters:

  - `business_id` (string, required)
    Business identifier for the request

## Request fields (application/json):

  - `amount` (number, required)
    Transfer amount
    Example: 100

  - `description` (string, required)
    Transfer description
    Example: Internal transfer between accounts

  - `currency` (string, required)
    Currency code (ISO 4217)
    Example: USD

  - `fromWalletId` (string, required)
    Source wallet ID
    Example: wallet_1

  - `toWalletId` (string, required)
    Destination wallet ID
    Example: wallet_2

  - `reference` (string)
    Reference (auto-generated if not provided)
    Example: FX_a1b2c3d4e5