Nightly docs
Tutorials
These tutorials give step-by-step instructions for NautilusTrader features and workflows.
Most Python tutorials are Jupytext percent-format files in the docs tutorials directory. You can run these files directly as scripts or open them as notebooks with Jupytext. Rust tutorials use the commands shown on their pages.
- Latest: docs built from the
masterbranch for stable releases. See https://nautilustrader.io/docs/latest/tutorials/. - Nightly: docs built from the
developbranch for experimental features. See https://nautilustrader.io/docs/nightly/tutorials/.
Recommended order
If you are new to NautilusTrader, complete these tutorials in order:
- Quickstart: Run your first backtest in five minutes with synthetic data.
- Backtest (Low-Level API): Use
BacktestEnginedirectly with real market data and execution algorithms. - Backtest (High-Level API): Run config-driven backtests
with
BacktestNodeand the Parquet data catalog. - Loading External Data: Load CSV or other external data into the
ParquetDataCatalog(how-to guide). - Backtest with FX Bar Data: Backtest FX bars with rollover interest simulation.
- Select a topic-specific tutorial below.
Backtesting
| Tutorial | Description | Language | Data requirement |
|---|---|---|---|
| Backtest with FX Bar Data | EMA cross on FX bars with rollover simulation. | Python | Sample |
| Backtest with Order Book Depth Data (Binance) | Order book imbalance strategy on depth data. | Python | Sample or user-provided |
| Backtest with Order Book Depth Data (Bybit) | Order book imbalance strategy on depth data. | Python | Sample or user-provided |
| Backtest with Pre-IPO Order Book Data (CoinAPI) | Order book imbalance on ANTHROPIC-PERP. | Python | CoinAPI Flat Files key |
| Backtest with Polymarket Order Book Data (FinFeed) | Order book imbalance on Bitcoin Yes shares. | Python | FinFeed historical key |
| Book Imbalance Backtest (Betfair) | Book imbalance strategy on Betfair L2 data. | Rust | Sample or user-provided |
Data workflows
For task-oriented data recipes, see the how-to guides:
| Guide | Description | Language | Data requirement |
|---|---|---|---|
| Loading External Data | Load external data into the ParquetDataCatalog. | Python | User-provided |
| Data Catalog with Databento | Set up a catalog with Databento schemas. | Python | Databento API key |
Strategy patterns
| Tutorial | Description | Language | Data requirement |
|---|---|---|---|
| Mean Reversion with Proxy FX Data (AX Exchange) | Bollinger Band mean reversion on EURUSD-PERP. | Python | TrueFX proxy |
| Gold Perpetual Book Imbalance with Proxy Futures Data (AX Exchange) | Order book imbalance on XAU-PERP. | Python | Databento API key |
| On-Chain Grid Market Making with Short-Term Orders (dYdX) | Grid MM on dYdX v4 perpetuals. | Rust | Live API |
| Composite Market Making on Lighter RWA with Databento US Equities NVDA | Signal-skewed MM on NVDA-PERP. | Rust, Python | Databento + Lighter |
| Hurst/VPIN Directional Strategy (Kraken Futures) | Regime-filtered informed-flow strategy on PF_XBTUSD. | Rust | Tardis.dev |
Options
| Tutorial | Description | Language | Data requirement |
|---|---|---|---|
| Options Data and Greeks (Bybit) | Stream Greeks and option chain snapshots. | Rust | Live API |
| Delta-Neutral Options Strategy (Bybit) | Short strangle with perpetual delta hedging. | Rust | Live API |
| Delta-Neutral Options Strategy (Derive) | Derive ETH strangle hedger with premium entry. | Rust | Live API |
Run Live Trading (Rust)
The LiveNode connects to real venues and data sources through adapter clients. This guide walks through a complete live trading setup using OKX as an example.
Book Imbalance Backtest (Betfair)
This tutorial backtests the Rust OrderBookImbalance strategy on a Betfair MATCH_ODDS market. It loads a raw historical streaming file, feeds it through...