Skip to content
These docs describe Tradr v0.17.0. Running an older release? Check the release notes for what changed.

Record a deposit or withdrawal.

POST
/api/ledger/{accountId}/cash-movements
curl --request POST \
--url https://api.tradr.cloud/api/ledger/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/cash-movements \
--header 'Content-Type: application/json' \
--data '{ "amount": "1000.00", "occurredAt": "2026-04-15T12:00:00Z", "type": "deposit" }'

Posts a single ledger entry, in the account’s currency, for money moved into or out of this brokerage account, and moves the balance by the amount — a deposit credits it, a withdrawal debits it. occurredAt defaults to now and may be in the past. Tradr’s balance is cash only and holds no mark-to-market, so a withdrawal larger than the balance is accepted and the balance goes negative rather than being blocked. Append-only: to correct a mistake, delete the movement — which appends a reversal — and record it again; every entry persists.

accountId
required
string format: uuid
Media typeapplication/json
object
amount
required

Positive decimal string, greater than zero, with at most 4 fractional digits and no more than the account currency’s minor units.

string
Example
1000.00
occurredAt

RFC-3339 timestamp with offset. Omitted means now.

string format: date-time
type
required
string
Allowed values: deposit withdrawal

The recorded entry, plus the balance either side of it.

Media typeapplication/json
object
entry
object
newBalance
string
previousBalance
string
Example
{
"newBalance": "2000.0000",
"previousBalance": "1000.0000"
}

Type or amount is malformed

Not authenticated.

No such account for this user.