Skip to main content
POST
/
api
/
external
/
swap
curl --request POST \
  --url https://api-prod.blaaiz.com/api/external/swap \
  --header 'Content-Type: application/json' \
  --header 'x-blaaiz-api-key: <api-key>' \
  --data '
{
  "from_business_wallet_id": "1bc6b6f9-f795-4b78-b8cb-5f4de267c301",
  "to_business_wallet_id": "8fbf7dc8-2082-4486-8ef0-44d5bb758a8c",
  "amount": 100,
  "amount_type": "from"
}
'
{
  "message": "Money swap successful!",
  "business_swap_transaction": {
    "id": "d275cd12-e679-43ee-90ce-c8df363624f8",
    "business_id": "business_123",
    "business_user_id": "business_user_123",
    "business_transaction_id": "txn_123456789",
    "from_business_wallet_id": "1bc6b6f9-f795-4b78-b8cb-5f4de267c301",
    "from_currency": "USD",
    "from_currency_id": 2,
    "from_amount": 100,
    "from_amount_minus_fees": 99,
    "to_currency": "NGN",
    "to_currency_id": 1,
    "to_amount": 160000,
    "from_exchange_rate": 1600,
    "custom_exchange_rate": null,
    "to_business_wallet_id": "8fbf7dc8-2082-4486-8ef0-44d5bb758a8c",
    "reference": "swap_ref_001",
    "comments": null,
    "status": "SUCCESSFUL",
    "amount_type": "from",
    "created_at": "2026-03-13T09:15:00.000000Z",
    "updated_at": "2026-03-13T09:15:00.000000Z"
  }
}

Authorizations

​
x-blaaiz-api-key
string
header
required

Body

application/json
​
from_business_wallet_id
string
required

ID of the source business wallet to debit.

​
to_business_wallet_id
string
required

ID of the destination business wallet to credit.

​
amount
number
required

Amount to swap. Minimum value is 0.1 and up to 2 decimal places are accepted.

​
amount_type
enum<string>

How to interpret the amount. Use from to specify the source-wallet amount, or to to specify the destination-wallet amount. Defaults to from.

Available options:
from,
to

Response

Swap completed successfully.

​
message
string
required
​
business_swap_transaction
object
required