How frequently should the reconciliation process run?

It is recommended to run reconciliation every 15 to 60 minutes. This skill's verified workflow suggests an interval of 120 loops at a 15-second heart-beat (30 minutes).

Why is position reconciliation necessary for trading bots?

Internal database states often drift from actual broker positions due to network latency, missed webhooks, or manual trades made outside the bot. Reconciliation ensures the bot remains synced with reality.

Does this skill handle fractional shares correctly?

Yes, it uses a floating-point tolerance (typically 0.001 shares) to compare quantities, preventing false discrepancies caused by standard float precision issues.

What happens if the broker API fails during a sync?

The implementation is designed to be non-breaking; it logs the error and continues using the existing internal state rather than raising an exception and stopping the trading system.

Position Reconciliation

Name: Position Reconciliation
Author: smith6jt-cop

bysmith6jt-cop

0•

Analytics & Monitoring

Synchronizes internal trading states with live broker positions to eliminate data drift and ensure execution accuracy.

This skill provides a robust architectural pattern for reconciling internal trading system states with a broker's actual records. By treating the broker as the single source of truth, it automatically detects and corrects discrepancies caused by network failures, manual interventions, or partial fills. It includes a verified Python implementation for periodic synchronization, fractional share handling, and error-resilient logging, ensuring that automated trading strategies always operate on accurate, real-world position data.

Key Features

010 GitHub stars

02Discrepancy audit logging with 'RECONCILE' prefixes

03Periodic drift detection and automated correction

04Fail-safe integration for live trading loops

05Fractional share support with floating-point tolerance

06Broker-as-source-of-truth state synchronization

Use Cases

01Maintaining state accuracy in algorithmic trading bots

02Handling complex fills and corporate actions like stock splits

03Correcting internal data after manual broker UI interventions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add smith6jt-cop/skills_registry position-reconciliation

For use in Claude.ai and ChatGPT

Download Skill