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

Update an account.

PUT
/api/accounts/{id}
curl --request PUT \
  --url https://api.tradr.cloud/api/accounts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Content-Type: application/json' \
  --data '{ "brokerageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "currency": "example", "defaultRiskPercent": "1.00", "name": "example", "timezone": "America/New_York" }'

Authed. All fields optional. startingBalance is deliberately absent — it is creation-only. timezone IS editable: it changes only subsequent trading-day evaluations and rewrites no history, and defaultRiskPercent is editable for the same reason.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
brokerageId
string format: uuid
nullable
currency
string
>= 3 characters <= 3 characters
defaultRiskPercent

Share of the account balance risked per trade (decimal string above 0, up to 100, at most 2 decimal places). Omitting the key leaves the stored value untouched; sending an explicit null clears the rule back to unset.

string
nullable
Example
1.00
name
string
>= 1 characters
timezone

IANA zone name (canonical spelling). Unknown zone is a 400.

string
Example
America/New_York

Responses

Section titled “Responses”

200

Section titled “200”

The updated account. isDemo is server-set and unchanged by this call.

400

Section titled “400”

Validation error (includes an unknown IANA timezone).

403

Section titled “403”

FORBIDDEN (cross-user brokerage).

404

Section titled “404”

Account not found.

409

Section titled “409”

Duplicate account name, or currency change while positions exist.