Reconciliation

Reconciliation replays trading activity over a time window and applies stage-by-stage corrections to firm evaluation and sim-funded accounts. All routes are firm-scoped via X-Firm-ID (auto-injected for firm API keys) or an optional firm_id query parameter.

Time window

Preview and start both accept the same window body:

Field	Required	Notes
`start_at`	yes	RFC 3339 timestamp. Inclusive.
`end_at`	yes	RFC 3339 timestamp. Exclusive.

Get active job

GET /v1/firm-control/reconciliations/active

operationId: getActiveReconciliationJob Returns the in-progress reconciliation job for the firm, if any.

curl -sS "$TRADARA_BASE_URL/v1/firm-control/reconciliations/active" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY"

Response — `200 OK`

{
  "item": {
    "id": "rec_01HW...",
    "firm_id": "8f4a1d6e-2b1c-4e9a-9d3b-5e6c7a0d1f23",
    "start_at": "2026-06-25T00:00:00Z",
    "end_at": "2026-06-26T00:00:00Z",
    "status": "RUNNING",
    "accounts_total": 412,
    "accounts_done": 187,
    "error_summary": null
  }
}

Preview

POST /v1/firm-control/reconciliations/preview

operationId: previewReconciliation Computes reconciliation impact for a time window without mutating accounts.

curl -X POST "$TRADARA_BASE_URL/v1/firm-control/reconciliations/preview" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "start_at": "2026-06-25T00:00:00Z",
    "end_at":   "2026-06-26T00:00:00Z"
  }'

Response — `200 OK`

{
  "item": {
    "start_at": "2026-06-25T00:00:00Z",
    "end_at":   "2026-06-26T00:00:00Z",
    "evaluation": {
      "accounts_affected": 124,
      "total_credit": "8420.50",
      "accounts_unbreached": 17
    },
    "sim_funded": {
      "accounts_affected": 88,
      "total_credit": "21305.00",
      "accounts_unbreached": 9
    },
    "totals": {
      "accounts_affected": 212,
      "total_credit": "29725.50",
      "accounts_unbreached": 26
    }
  }
}

Start

POST /v1/firm-control/reconciliations

operationId: startReconciliation Starts an asynchronous reconciliation job.

curl -X POST "$TRADARA_BASE_URL/v1/firm-control/reconciliations" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "start_at": "2026-06-25T00:00:00Z",
    "end_at":   "2026-06-26T00:00:00Z"
  }'

Response — `202 Accepted`

{
  "item": {
    "id": "rec_01HW...",
    "firm_id": "8f4a1d6e-2b1c-4e9a-9d3b-5e6c7a0d1f23",
    "start_at": "2026-06-25T00:00:00Z",
    "end_at":   "2026-06-26T00:00:00Z",
    "status": "RUNNING",
    "accounts_total": 412,
    "accounts_done": 0,
    "error_summary": null
  }
}

Get job

GET /v1/firm-control/reconciliations/jobs?job_id={uuid}

operationId: getReconciliationJob

curl -sS "$TRADARA_BASE_URL/v1/firm-control/reconciliations/jobs?job_id=rec_01HW..." \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY"

Response — `200 OK`

{
  "item": {
    "id": "rec_01HW...",
    "firm_id": "8f4a1d6e-2b1c-4e9a-9d3b-5e6c7a0d1f23",
    "start_at": "2026-06-25T00:00:00Z",
    "end_at":   "2026-06-26T00:00:00Z",
    "status": "COMPLETED",
    "accounts_total": 412,
    "accounts_done": 412,
    "error_summary": null
  }
}

Errors

HTTP	Meaning
`400`	Missing/invalid `start_at` or `end_at`.
`409`	Another reconciliation is already running for the firm.
`502` / `503`	Downstream reconciliation service unavailable.

Overview

Account Provisioning

Terminal Embed

Firm & Users

Staff & RBAC

Offerings & Acceptance

API Keys

Webhooks

Realtime WebSocket

Operations

Firm Backoffice Reads

Terminal Onboarding (JWT)

Time window

Get active job

Response — `200 OK`

Preview

Response — `200 OK`

Start

Response — `202 Accepted`

Get job

Response — `200 OK`

Errors

​Time window

​Get active job

​Response — 200 OK

​Preview

​Response — 200 OK

​Start

​Response — 202 Accepted

​Get job

​Response — 200 OK

​Errors

Time window

Get active job

Response — `200 OK`

Preview

Response — `200 OK`

Start

Response — `202 Accepted`

Get job

Response — `200 OK`

Errors