Reconcile Failures

Reconciliation failures stop the broker to prevent trading on stale state.

Cause

• REST snapshot failures.
• Auth invalidation.
• Network outages during reconnect.

Symptom

• ReconcileFailureError raised on startup or reconnect.
• Broker stops and logs a fail-fast message.

Resolution

1. Validate token with fyers-auth.
2. Check REST connectivity (orderbook/positions).
3. Restart the process after resolving the root cause.

What NOT To Do

• Do not disable reconciliation to "keep trading".

Scenario Example

Scenario: WS reconnects but reconcile fails. - The broker stops instead of consuming WS messages. - Refresh token and restart the process.