Agent skill · marketing growth · sundial-org
ibkr-trading
Interactive Brokers (IBKR) trading automation via Client Portal API. Use when setting up IBKR account access, authenticating sessions, checking portfolio/positions, or building trading bots. Handles IBeam automated login with IBKR Key 2FA.
Why this skill is useful
Adds executable scripts for automated trading with Interactive Brokers, including authentication and order management workflows.
What it needs
Requires chromium-browser, chromium-chromedriver, openjdk-17-jre-headless, xvfb installed locally. Requires ibkr account access. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
IBKR Trading Skill Automate trading with Interactive Brokers using the Client Portal Gateway API. Overview This skill enables: Automated IBKR authentication via IBeam + IBKR Key Portfolio and position monitoring Order placement and management Building custom trading strategies Prerequisites IBKR account (live or paper) IBKR Key app installed on phone (for 2FA) Linux server with Java 11+ and Chrome/Chromium Quick Setup 1. Install Dependencies 2. Download Client Portal Gateway 3. Configure Credentials Create ~/trading/.env: Authentication Start Gateway + Authenticate Important: User must approve IBKR Key notification on phone within ~2 minutes! Check Auth Status Authenticated response includes "authenticated": true. API Usage Account Info Positions Market Data Place Orders Session Management Sessions expire after ~24 hours. Options: 1. Keepalive cron - Ping /v1/api/tickle every 5 min 2. Auto re-auth - Run IBeam when session expires (requires phone approval) Keepalive Script Troubleshooting Issue Solution ------- ---------- Gateway not responding Check if Java process is running: ps aux \ grep GatewayStart Login timeout User didn't approve IBKR Key in time - retry auth Connection refused Gateway not started - run bin/run.sh root/conf.yaml Chrome errors Ensure Xvfb is running: Xvfb :99 & and export DISPLAY=:99 Files Reference See references/api-endpoints.md for complete API documentation. See scripts/ for ready-to-use automation scripts.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/ibkr-trading