ITL.Webull.CLI

Production-ready Webull Market Data API client for algorithmic trading and market analysis.

Features

✅ HTTP Historical Data — OHLCV bars for any timeframe (M1-MN)
✅ MQTT Streaming — Real-time quotes (~250ms), ticks, snapshots
✅ Technical Analysis — SMA, momentum, gaps, volume built-in
✅ Multi-Symbol — Batch processing, watchlists
✅ Type-Safe — Pydantic models for all data
✅ Error Handling — Comprehensive logging and retry logic
✅ Async/Await — Full asyncio support

Quick Start

# Install
pip install -r requirements.txt

# Set credentials
export WEBULL_APP_KEY="your-key"
export WEBULL_APP_SECRET="your-secret"

# Run example
python examples/integration_example.py

Usage

import asyncio
from itl_webull import WebullMarketFeed, TimeframeEnum

async def main():
    feed = WebullMarketFeed(app_key, app_secret)
    
    # Get technical analysis
    data = await feed.get_analysis_data("AAPL", TimeframeEnum.M5, days=5)
    
    print(f"Price: ${data['summary']['current_price']:.2f}")
    print(f"SMA20: ${data['summary']['sma_20']:.2f}")

asyncio.run(main())

Documentation

• Setup Guide — Complete installation and configuration
• Examples — Working code samples
• API Reference — Source code documentation

Installation

From PyPI (when published)

pip install itl-webull

From source

git clone https://github.com/ITlusions/ITL.Webull.CLI.git
cd ITL.Webull.CLI
pip install -e .

Requirements

• Python 3.8+
• Webull OpenAPI account with market data subscription
• Active internet connection for API/MQTT

Project Structure

ITL.Webull.CLI/
├── src/itl_webull/          # Core package
│   ├── client.py            # Main API clients
│   ├── models.py            # Data models
│   └── constants.py         # Enums and constants
├── examples/                # Usage examples
├── docs/                    # Documentation
└── tests/                   # Test suite

License

MIT License — See LICENSE file for details

Support

• Webull Developer Portal
• Issues
• Documentation

---

Status: ✅ Production-Ready
Python: 3.8+
Maintained by: ITL Platform Team