v1.1.0 to v1.1.0

---

version: 1.1.0

---

# Broker Failover & Secondary Account Routing

This skill provides a rigorously engineered **Broker Failover Router** leveraging the Circuit Breaker design pattern. It ensures robust continuation of algorithmic order flow by dynamically rerouting to a secondary broker account when primary API connections degrade, experience latency spikes, or return critical HTTP 503/429 errors.

## Core Features

1. **Circuit Breaker Pattern (CLOSED, OPEN, HALF_OPEN):** Protects primary connections from cascading failures.

2. **Concurrency Safe:** Built-in threading locks handle concurrent order streams from multiple alpha models without race conditions.

3. **Automated Half-Open Probing:** After a predefined exponential backoff/timeout period, the system probes the primary broker with a single test order.

4. **Symbol Translation Mapping:** Normalizes canonical tickers to broker-specific formats (e.g., `AAPL` -> `AAPL STK SMART` vs `AAPL.S`).

## Integration Checklist

Check the `assets/checklist.md` for a comprehensive onboarding guide to integrate this into your institutional quant infrastructure.

## Folder Structure

- `scripts/`: Contains the core `failover_router.py` implementation and `test_failover_router.py` unit tests.

- `references/`: Documentation on institutional routing standards and sequence workflows.

- `assets/`: Integration checklists.

*Note: For production deployment, ensure the timeout values and backoff mechanisms are tuned to the specific exchange latency characteristics.*