Skip to main content
Execute the currency conversion. Debits the from_currency wallet and credits the to_currency wallet at the live rate. 
POST https://api.yativo.com/api/v1/swap/process
Requires Idempotency-Key header. Use a new, unique key for the process step — different from any key used in /swap/init.
​
from_currency
string
required
The source wallet currency code.
​
to_currency
string
required
The target wallet currency code.
​
amount
number
required
Amount in the source currency to convert.
​
transaction_purpose
string
Optional description recorded on the transaction.
curl -X POST 'https://api.yativo.com/api/v1/swap/process' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: swap-process-001' \
  -d '{
    "from_currency": "USD",
    "to_currency": "BRL",
    "amount": 500,
    "transaction_purpose": "Fund BRL wallet for local payouts"
  }'

{
  "status": "success",
  "status_code": 200,
  "message": "Request successful",
  "data": {
    "from_currency": "USD",
    "to_currency": "BRL",
    "from_amount": "500.00",
    "to_amount": "2491.00",
    "exchange_rate": "4.9820",
    "transaction_type": "currency_swap",
    "created_at": "2026-06-01T10:00:00.000000Z"
  }
}