dhiogoborba124-cloud

dhiogoborba124-cloud / flashalpha-fill-simulator

Public
18
0
85% credibility
Found May 17, 2026 at 18 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
AI Summary

This is a Python library that helps options traders test their strategies more honestly. Most backtesting tools assume you'll always fill at the perfect middle price, which is unrealistic. This simulator models what actually happens when you place limit orders: you wait until someone else crosses your price, stale quotes don't trick you into false fills, and exits don't magically walk down to better prices. It integrates with popular backtesting frameworks and gives you realistic results instead of inflated ones. The project is well-documented, includes comprehensive tests, and comes from a legitimate trading firm that open-sourced this tool after discovering their own strategy returns dropped dramatically when they modeled execution honestly.

How It Works

1
📊 You run a backtest and feel suspicious

Your options trading strategy shows amazing returns, but something feels off about those perfect fills.

2
🤔 You realize the problem

Standard backtesting tools assume you'll always fill at the exact middle price, which never happens in real markets.

3
🔍 You discover the fill simulator

A tool that models what really happens when you place a limit order: waiting for someone to cross your price, handling stale quotes, and realistic exit strategies.

4
🔗 You connect it to your trading system

Drop the simulator into your existing backtesting framework and it automatically replaces your naive fill logic.

5
You run your strategy with realistic fills
✅
Your strategy still wins

If your edge survives honest fill modeling, it's a real signal worth trading.

⚠️
Your strategy looks weaker

If your returns collapse with realistic fills, you just saved yourself from a bad strategy.

🎯 You trade with honest expectations

Now you know whether your strategy has a genuine edge or was just an artifact of unrealistic testing.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 18 to 18 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is flashalpha-fill-simulator?

A Python library that simulates realistic limit-order fills for options credit spreads. Most backtesting tools fill your orders at mid-price or at bid/ask without accounting for queue position. This library models what actually happens: your limit order sits on the book until someone else crosses your price, with stale-quote guards and deterministic tiebreaking. It's the execution layer you need when your strategy returns look suspiciously good.

Why is it gaining traction?

Options traders have long known that backtest returns collapse when you model fills honestly. This library exposes the gap between "would have filled" and "would have actually filled" by implementing post-and-wait limits, epsilon thresholds, and patient exit logic. The hook is simple: if your strategy only works with optimistic fill assumptions, it probably doesn't work. The library is engine-agnostic and data-source-agnostic, so it plugs into QuantConnect, Backtrader, or any custom backtester.

Who should use this?

Options traders running credit spreads on personal accounts or small prop desks. QuantConnect and Backtrader users who want honest execution modeling. Developers building custom backtesting tools who need to replace naive mid-price fill logic. Not suitable for institutional-scale simulations where queue position and size matter.

Verdict

This library solves a real problem that most options backtesters ignore. The execution modeling is thoughtful and the API is clean, but with only 19 stars and a credibility score of 0.8500000238418579%, it's early-stage and unproven at scale. Worth trying if you want to stress-test your strategy's assumptions, but treat the numbers as directional until it accumulates more battle-testing in production environments.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.