MCPcopy
hub / github.com/edtechre/pybroker

github.com/edtechre/pybroker @v1.2.12 sqlite

repository ↗ · DeepWiki ↗ · release v1.2.12 ↗
1,060 symbols 4,520 edges 33 files 314 documented · 30%
README

PyBroker

python Apache 2.0 with Commons Clause Documentation Status Package status Downloads Github stars Twitter

Algorithmic Trading in Python with Machine Learning

Are you looking to enhance your trading strategies with the power of Python and machine learning? Then you need to check out PyBroker! This Python framework is designed for developing algorithmic trading strategies, with a focus on strategies that use machine learning. With PyBroker, you can easily create and fine-tune trading rules, build powerful models, and gain valuable insights into your strategy’s performance.

Key Features

  • A super-fast backtesting engine built in NumPy and accelerated with Numba.
  • The ability to create and execute trading rules and models across multiple instruments with ease.
  • Access to historical data from Alpaca, Yahoo Finance, AKShare, or from your own data provider.
  • The option to train and backtest models using Walkforward Analysis, which simulates how the strategy would perform during actual trading.
  • More reliable trading metrics that use randomized bootstrapping to provide more accurate results.
  • Caching of downloaded data, indicators, and models to speed up your development process.
  • Parallelized computations that enable faster performance.

With PyBroker, you'll have all the tools you need to create winning trading strategies backed by data and machine learning. Start using PyBroker today and take your trading to the next level!

Installation

PyBroker supports Python 3.9+ on Windows, Mac, and Linux. You can install PyBroker using pip:

   pip install -U lib-pybroker

Or you can clone the Git repository with:

   git clone https://github.com/edtechre/pybroker

A Quick Example

Get a glimpse of what backtesting with PyBroker looks like with these code snippets:

Rule-based Strategy:

   from pybroker import Strategy, YFinance, highest

   def exec_fn(ctx):
      # Get the rolling 10 day high.
      high_10d = ctx.indicator('high_10d')
      # Buy on a new 10 day high.
      if not ctx.long_pos() and high_10d[-1] > high_10d[-2]:
         ctx.buy_shares = 100
         # Hold the position for 5 days.
         ctx.hold_bars = 5
         # Set a stop loss of 2%.
         ctx.stop_loss_pct = 2

   strategy = Strategy(YFinance(), start_date='1/1/2022', end_date='7/1/2022')
   strategy.add_execution(
      exec_fn, ['AAPL', 'MSFT'], indicators=highest('high_10d', 'close', period=10))
   # Run the backtest after 20 days have passed.
   result = strategy.backtest(warmup=20)

Model-based Strategy:

   import pybroker
   from pybroker import Alpaca, Strategy

   def train_fn(train_data, test_data, ticker):
      # Train the model using indicators stored in train_data.
      ...
      return trained_model

   # Register the model and its training function with PyBroker.
   my_model = pybroker.model('my_model', train_fn, indicators=[...])

   def exec_fn(ctx):
      preds = ctx.preds('my_model')
      # Open a long position given my_model's latest prediction.
      if not ctx.long_pos() and preds[-1] > buy_threshold:
         ctx.buy_shares = 100
      # Close the long position given my_model's latest prediction.
      elif ctx.long_pos() and preds[-1] < sell_threshold:
         ctx.sell_all_shares()

   alpaca = Alpaca(api_key=..., api_secret=...)
   strategy = Strategy(alpaca, start_date='1/1/2022', end_date='7/1/2022')
   strategy.add_execution(exec_fn, ['AAPL', 'MSFT'], models=my_model)
   # Run Walkforward Analysis on 1 minute data using 5 windows with 50/50 train/test data.
   result = strategy.walkforward(timeframe='1m', windows=5, train_size=0.5)

User Guide

Online Documentation

The full reference documentation is hosted at www.pybroker.com.

(For Chinese users: 中文文档, courtesy of Albert King.)

Contact

Market-Moving Stock News & Alerts

AI-driven market analysis for the stocks you follow. Receive real-time AI alerts and sentiment analysis for 10,000+ tickers at www.movealerts.ai.

Core symbols most depended-on inside this repo

incr_bars
called by 67
src/pybroker/portfolio.py
buy
called by 63
src/pybroker/portfolio.py
fetch
called by 51
src/pybroker/scope.py
sell
called by 48
src/pybroker/portfolio.py
instance
called by 44
src/pybroker/scope.py
check_stops
called by 40
src/pybroker/portfolio.py
indicator
called by 38
src/pybroker/indicator.py
to_datetime
called by 35
src/pybroker/common.py

Shape

Function 493
Method 464
Class 102
Route 1

Languages

Python100%

Modules by API surface

tests/test_strategy.py109 symbols
src/pybroker/indicator.py85 symbols
tests/test_context.py79 symbols
tests/test_portfolio.py72 symbols
src/pybroker/log.py67 symbols
src/pybroker/context.py63 symbols
tests/test_scope.py57 symbols
src/pybroker/scope.py52 symbols
src/pybroker/vect.py47 symbols
tests/test_data.py45 symbols
src/pybroker/portfolio.py44 symbols
src/pybroker/eval.py44 symbols

Dependencies from manifests, versioned

Sphinx5.3.0 · 1×
akshare1.10.1 · 1×
alpaca-py0.7.2 · 1×
diskcache5.4.0 · 1×
flake85.0.4 · 1×
flake8-bugbear22.10.25 · 1×
joblib1.2.0 · 1×
jupyter1.0.0 · 1×
matplotlib3.9.1 · 1×
mypy0.982 · 1×
nbsphinx0.8.11 · 1×
numba0.60.0 · 1×

For agents

$ claude mcp add pybroker \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact