Record a deposit or withdrawal.
const url = 'https://api.tradr.cloud/api/ledger/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/cash-movements';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"amount":"1000.00","occurredAt":"2026-04-15T12:00:00Z","type":"deposit"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”object
Positive decimal string, greater than zero, with at most 4 fractional digits and no more than the account currency’s minor units.
Example
1000.00RFC-3339 timestamp with offset. Omitted means now.
Responses
Section titled “ Responses ”The recorded entry, plus the balance either side of it.
object
object
Example
{ "newBalance": "2000.0000", "previousBalance": "1000.0000"}Type or amount is malformed
Not authenticated.
No such account for this user.