TreasuryWireAPI docsSign inGet API keys

Wallet transfers

Move money between two wallets in your ledger. No bank or provider is involved, so it is instant and free of provider fees.

Transfer between wallets

POST/ledger/account/transfer

Debits the sender's wallet and credits the recipient's in one atomic posting. Both wallets must already exist in the currency, and the sender needs enough balance.

BodyTypeDescription
fromOwnerRefrequiredstringThe sender. Their wallet in this currency is debited.
toOwnerRefrequiredstringThe recipient. Their wallet in this currency is credited.
currencyrequiredstringThree-letter currency code.
amountrequirednumberMajor units, greater than 0. 1500.50 is ₦1,500.50.
referencestringYour idempotency reference. Generated if omitted, but then you can't safely retry.
200 OK
{
  "message": "Transfer completed",
  "status": "OK",
  "transactionId": "665f2a0b9a3b4c0012ab3501",
  "reference": "order_8841_refund"
}
StatusMeaning
200Transfer completed, or already processed for this reference.
404The sender's or the recipient's wallet doesn't exist.
422Validation error, insufficient balance, or sending to yourself.
curl -X POST "https://usetreasurywire.com/api/v1/ledger/account/transfer" \
  -H "Authorization: Bearer $TREASURYWIRE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromOwnerRef": "cust_1001",
    "toOwnerRef": "cust_1002",
    "currency": "NGN",
    "amount": 1500.5,
    "reference": "order_8841_refund"
  }'