Sign in
Transfers

Create Transfer

Moves funds out of an account. type selects the kind of movement (default ledger): ledger transfers credit between two ledger accounts and returns a Transfer; wallet_send sends USDT from the origin account's Ethereum wallet to a recipient; claim_link funds a shareable claim link anyone with the URL can redeem.

post/transfers

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

amountnumber required

The amount to move, in the transfer currency. For example 25.00.

currencystring

Currency, such as usd. Required for ledger transfers.

destination_idstring

The recipient. Required for ledger and wallet_send (a user_/biz_/ldgr_ ID, or — for sends — an email). Omit for claim_link.

expires_atstring date-time nullable

claim_link only. Link expiry as an ISO 8601 timestamp. Defaults to 24 hours from creation.

idempotence_keystring nullable

Ledger transfers only. A unique key to prevent duplicate transfers.

metadataobject nullable

Ledger transfers only. Custom key-value pairs attached to the transfer. Max 50 keys, 100 chars per key, 500 chars per string value.

notesstring nullable

Ledger transfers only. A short note describing the transfer.

origin_idstring required

The account sending the funds. A user ID (user_xxx), account ID (biz_xxx), or ledger account ID (ldgr_xxx).

redeemable_countinteger

claim_link only. How many different users can claim the link. Defaults to 1.

type'ledger' | 'wallet_send' | 'claim_link'

The kind of money movement. Defaults to ledger.

Example request

{
  "currency": "usd"
}

Response

money movement created

OR
OR

Changes