Skip to main content
Backwards-incompatible API changes are announced here at least 30 days before they ship. Additive changes (new fields, new endpoints) ship without notice but are still recorded below.
Subscribe to the firm.api.changelog event on the firm WebSocket to receive in-band notifications about API deprecations and breaking changes.

​
2026-09-27 — Purchase id and price on generated accounts

  • POST /v1/firm-control/accounts accepts an optional idempotency_key. The value is unique among that firm’s accounts. Repeating it returns the original account (200) instead of creating a second one.
  • GET /v1/firm-control/accounts accepts idempotency_key to look up that account.
  • POST /v1/firm-control/accounts accepts an optional price_paid. Tradara stores that purchase amount on the account. A bulk create divides it across the accounts in the request, and each account keeps its share.

​
2026-09-18 — Firm live risk-state read

​
2026-09-17 — Firm account replacement

​
2026-09-16 — Daily-loss migration re-anchor

​
2026-09-14 — Firm cash adjustments and account max-loss cap

​
2026-08-30 — Firm event catalog

  • Added positions.created to FirmEventType. Positions already dual-published this type; the enum and docs omitted it.
  • Footprint now dual-publishes fingerprints.flagged on the same shared-device trigger as devices.flagged / ip_logs.flagged.
  • Catalog changelog lives on Event catalog.

​
2026-08-30 — Per-account trading control in Prop Firm docs

  • Documented lock/unlock, flatten, cancel, and live order/position reads under Per-account trading control. These routes already existed on the gateway with a firm API key; they were not listed next to emergency halt.
  • Flatten returns cancel/close counts after the OMS submits offset orders. Resulting positions are read with GET /v1/accounts/{account_id}/positions.

​
2026-08-24 — Per-account rule overlays on generate

  • POST /v1/firm-control/accounts accepts optional initial_balance, currency, risk_profile, and passing_criteria.
  • When those overlays are present, Tradara clones the template risk profile and/or passing criteria so the new account does not share catalog rows with other accounts on the same plan.
  • PUT /v1/firm-control/offerings remains a product-family enablement toggle, not a SKU rule editor.

​
2026-06-27 — Realtime WebSocket reference

  • Added Trading API realtime reference for the trader-scoped /v1/ws stream.
  • Added Prop Firm realtime reference for the firm-scoped /v1/firm-ws stream, including AsyncAPI playground.
  • Removed the legacy per-resource SSE pages — /trading/orders/streaming, /trading/fills/streaming, and /trading/positions/streaming now redirect to the realtime overview.
  • Documented POST /v1/orders/groups/oco/link and POST /v1/orders/groups/oco/companion. Both were in the implementation; the OpenAPI spec is updated to match.

​
2026-06-01 — Idempotency window extended

  • Idempotency-Key retention on POST /v1/orders extended from 1 hour to 24 hours. No request changes required.

​
2026-05-10 — Prop Firm API GA

  • Promoted /v1/firm-control/* to general availability.
  • Added Account provisioning as the canonical onboarding entry point.
  • Introduced firm API keys with the tdr_live_ prefix.

​
2026-04-22 — Trading API public beta

  • First public release of /v1/orders, /v1/fills, /v1/positions, /v1/trades, /v1/balances, /v1/stats.
  • Cursor pagination across all list endpoints.
  • Standard error envelope rolled out across all services.
Have feedback on the public API or a deprecation timeline that doesn’t fit your roadmap? Reach out to your Tradara account contact.