Create Transfer

Moves balance between two members of the same owner. asset, amount, sender_id and recipient_id are all required.

POST/api/transfersAuth: Required

Request Body

assetstringRequired

Asset code.

amountstring | numberRequired

Positive decimal amount. Accepted as a string or a number.

sender_idnumberRequired

The member the funds come from.

recipient_idnumberRequired

The member the funds go to.

Response

The transfer. Both balances are already updated when this returns.

idnumberRequired

The transfer id.

amountstringRequired

The amount moved.

asset_idstringRequired

Asset code.

sender_idnumberRequired

The member debited.

recipient_idnumberRequired

The member credited.

updated_atstringRequired

When the record last changed.

created_atstringRequired

When the record was created.

Errors

Beyond the shared errors:

Code	Meaning
1001	sender_id, recipient_id or asset is invalid or not yours
1002	The sender does not have enough money
2058	The amount is not positive, or one of the two members has no account in that asset

POST/api/transfers

curl -X POST 'https://api.example.com/api/transfers' \
  -H 'Api-Token: YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '<body>'

BODY

{
  "asset": "trx",
  "amount": "100",
  "sender_id": 9668,
  "recipient_id": 9670
}

EXAMPLE RESPONSE

{
  "id": 2593,
  "amount": "100.0",
  "asset_id": "trx",
  "sender_id": 9668,
  "recipient_id": 9670,
  "updated_at": "2026-08-28T15:38:48.985Z",
  "created_at": "2026-08-28T15:38:48.985Z"
}