drumsergio/ibkr-telegram repository overview

⁠IBKR-Telegram

Self-hosted Telegram bot for Interactive Brokers, run with Docker Compose next to IB Gateway. Manage your portfolio, execute trades and monitor positions from Telegram.

⁠Disclaimer

This software is provided "as is" under the GPL-3.0 license⁠. Use at your own risk. The author(s) accept no liability for financial losses. This is not financial advice — test thoroughly with paper trading accounts before using real money.

⁠Features

• Several IBKR accounts from one bot, each on its own IB Gateway container, with per-account limits and margin modes.
• Any instrument IBKR supports (stocks, options, futures), chosen with asset_types in config.yaml.
• An option chain wizard for LEAPS: deep ITM strike matching and automatic contract resolution.
• Checks before every trade: market hours, duplicate signals, position limits, and a Telegram confirmation.
• Periodic position snapshots, P&L tracking, and deposit/withdrawal history through the IBKR Flex Web Service.
• Soft (alert) or hard (auto-sell) margin enforcement per account.
• An optional webhook API for signals from TradingView or your own parsers, behind the same confirmation step.

⁠Quick start

You need an IBKR account with API access, a bot token from @BotFather⁠, and Docker Compose.

git clone https://github.com/GeiserX/IBKR-Telegram.git && cd IBKR-Telegram
cp .env.example .env && cp config.example.yaml config.yaml && cp docker-compose.example.yml docker-compose.yml
docker compose up -d

Fill in .env and config.yaml before starting, complete the IB Gateway 2FA on first start, then send /status to the bot. Getting started⁠ has every step.

⁠Documentation

• Getting started⁠: prerequisites and first start
• Configuration⁠: config.yaml, environment variables, margin modes, IB Gateway
• Usage⁠: every Telegram command
• Webhook API⁠: sending trade signals over HTTP
• How it works⁠: how the pieces fit
• Troubleshooting⁠
• Development⁠: tests, linting and contributing

⁠License

GPL-3.0-or-later⁠