Trading Accounts

A trading account is the core entity used for all trading activity on the Match-Trader platform. Each trading account belongs to exactly one user account and is identified by both a numeric login and a UUID. Trading accounts hold financial state (balance, equity, margin, etc.) and are assigned to a group which defines their trading conditions.

Every trading account resource includes a version field - a numeric revision counter that is used for optimistic locking.

When multiple systems or services update the same trading account concurrently, there is a risk that one update silently overwrites another. The version field prevents this: each successful update increments the version, and any update request that carries an outdated version is rejected, forcing the caller to re-fetch the latest state and retry.

Typical flow:

1. Fetch the trading account — note the current version value in the response.
2. Send your update request — include that version in the request body.
3. If the request is rejected due to a version mismatch, re-fetch the account to get the latest version and retry.

Omitting version from an update request will result in a validation error.