unusual-whales-to-ibkr-bot

Python

This Python bot fetches real-time options flow alerts from the [Unusual Whales Public API](https://unusualwhales.com/public-api), filters them based on your custom rules, and prepares them for automated trading through Interactive Brokers (IBKR).

Last updated Jul 1, 2026

Stars

Forks

Issues

Stars/day

Attention Score

View on GitHub ↗ Open in github.dev

Topics

#algorithmic-trading #ibkr #interactive-brokers #options #python #trading-bot #unusual-whales

Language breakdown

Python 100.0%

▸ Files click to expand

README

Unusual Whales to IBKR Trading Bot

This Python bot fetches real-time options flow alerts from the Unusual Whales Public API, filters them based on your custom rules, and prepares them for automated trading through Interactive Brokers (IBKR).

✅ Features

Real-time options flow data from Unusual Whales
Custom filters:

- Expiry ≥ 30 days - Average fill ≥ $5 - Premium ≥ $100,000

Easy-to-modify filtering logic
Modular structure ready for IBKR order execution

📦 Requirements

Python 3.8+
requests
python-dotenv
An active Unusual Whales API key
IBKR TWS or IB Gateway running (for integration)

Install dependencies:

pip install -r requirements.txt



🔐 .env Setup

Create a .env file in the root directory:


<pre><code class="lang-">UNUSUALWHALESAPIKEY=yourapikeyhere</code></pre>

🚀 Run the Bot
<pre><code class="lang-bash">python bot.py</code></pre>
The bot will scan alerts every 60 seconds, apply your filters, and print trade-ready alerts.

🛠 To-Do (Next Steps)

[ ] Integrate IBKR via ib_insync`
[ ] Add Discord/Webhook notifications
[ ] Optional: Web UI to control filters
[ ] Docker deployment

📄 License

MIT License — Free for personal and commercial use.

🔗 More in this category