Martingale42/nautilus-dev / skills/nt-signals
nt-signals
UnverifiedUse when working with indicators, signal generation, bar aggregation, custom data types, analysis statistics, or tearsheets in NautilusTrader.
nt-signals
What This Skill Covers
NautilusTrader signals and analysis domain — indicators, custom data types, bar aggregation, portfolio statistics, and reporting.
Python modules: indicators/, data/aggregation, model/data, model/book, model/custom, analysis/
Rust crates: nautilus_indicators, nautilus_analysis, nautilus_model (data subset)
When To Use
- Using or building custom indicators (EMA, RSI, Bollinger Bands, etc.)
- Signal generation and publishing
- Bar aggregation (custom bar types, time/tick/volume bars)
- Defining custom data types (
@customdataclass) - Portfolio statistics, tearsheets, and analysis reporting
- Order book data processing
When NOT To Use
- Strategy order logic → use
nt-trading - Data persistence or catalog → use
nt-data - Domain model types (instruments, identifiers) → use
nt-model - Backtest engine configuration → use
nt-backtest
Python Usage
Built-in Indicators
from nautilus_trader.indicators.average.ema import ExponentialMovingAverage
from nautilus_trader.indicators.rsi import RelativeStrengthIndex
from nautilus_trader.indicators.bollinger_bands import BollingerBands
# Create indicators
ema_fast = ExponentialMovingAverage(period=10)
ema_slow = ExponentialMovingAverage(period=20)
rsi = RelativeStrengthIndex(period=14)
# Register in strategy's on_start():
self.register_indicator_for_bars(bar_type, ema_fast)
self.register_indicator_for_bars(bar_type, ema_slow)
Indicator categories:
- Averages:
ExponentialMovingAverage,SimpleMovingAverage,WeightedMovingAverage,AdaptiveMovingAverage,HullMovingAverage,DoubleExponentialMovingAverage,WilderMovingAverage,VariableIndexDynamic - Momentum:
RelativeStrengthIndex,Stochastics,CommodityChannelIndex,RateOfChange - Volatility:
BollingerBands,AverageTrueRange,KeltnerChannel,DonchianChannel,VolatilityRatio - Trend:
AroonOscillator,DirectionalMovement,LinearRegression,ArcherMovingAveragesTrends - Volume:
OnBalanceVolume,VolumeWeightedAveragePrice
Bar Aggregation
from nautilus_trader.model.data import BarType, BarSpecification
from nautilus_trader.model.enums import BarAggregation, PriceType
# Time bars
bar_type = BarType.from_str("ETHUSDT-PERP.BINANCE-1-MINUTE-LAST-EXTERNAL")
# Tick bars
tick_bars = BarSpecification(step=100, aggregation=BarAggregation.TICK, price_type=PriceType.LAST)
# Volume bars
vol_bars = BarSpecification(step=1000, aggregation=BarAggregation.VOLUME, price_type=PriceType.LAST)
Custom Data Types
from nautilus_trader.model.custom import customdataclass
@customdataclass
class MySignalData:
signal_value: float
signal_strength: int
# ts_event and ts_init auto-provided by decorator
Analysis & Tearsheets
from nautilus_trader.analysis.analyzer import PortfolioAnalyzer
from nautilus_trader.analysis.reporter import ReportProvider
analyzer = PortfolioAnalyzer()
# analyzer automatically registered in backtest/live node
# Access via node.analyzer after run
Python Extension
Custom Indicator
Subclass Indicator and implement handle_bar(), update_raw(), _reset():
from nautilus_trader.indicators import Indicator
class MyIndicator(Indicator):
def __init__(self, period: int):
super().__init__(params=[period])
self.period = period
self.value = 0.0
self.count = 0
def handle_bar(self, bar):
self.update_raw(bar.close.as_double())
def update_raw(self, value: float):
if not self.has_inputs:
self._set_has_inputs(True)
# TODO: Core calculation
self.count += 1
if not self.initialized and self.count >= self.period:
self._set_initialized(True)
def _reset(self):
self.value = 0.0
self.count = 0
See templates/indicator.py for full template.
Custom PortfolioStatistic
from nautilus_trader.analysis.statistic import PortfolioStatistic
class MyStatistic(PortfolioStatistic):
def calculate_from_returns(self, returns):
if not self._check_valid_returns(returns):
return None
return float(returns.mean())
Return values must be JSON-serializable (float, int, str, bool, None).
See templates/portfolio_statistic.py for full template.
Custom Data Types
Use @customdataclass decorator — it auto-generates serialization methods (dict, bytes, Arrow). See templates/custom_data.py.
Rust Usage
use nautilus_indicators::average::ema::ExponentialMovingAverage;
use nautilus_indicators::rsi::RelativeStrengthIndex;
use nautilus_analysis::analyzer::PortfolioAnalyzer;
Rust Extension
Custom Indicator in Rust
Rust indicators are significantly faster for compute-heavy calculations (e.g., order book features, multi-timeframe analysis). Implement the Indicator trait:
use pyo3::prelude::*;
use nautilus_indicators::indicator::Indicator;
#[pyclass]
pub struct MyRustIndicator {
period: usize,
value: f64,
count: usize,
has_inputs: bool,
initialized: bool,
}
#[pymethods]
impl MyRustIndicator {
#[new]
fn new(period: usize) -> Self {
Self { period, value: 0.0, count: 0, has_inputs: false, initialized: false }
}
fn handle_bar(&mut self, bar: &Bar) {
self.update_raw(bar.close.as_f64());
}
fn update_raw(&mut self, value: f64) {
self.has_inputs = true;
// Core calculation
self.count += 1;
if self.count >= self.period {
self.initialized = true;
}
}
fn reset(&mut self) {
self.value = 0.0;
self.count = 0;
self.has_inputs = false;
self.initialized = false;
}
#[getter]
fn value(&self) -> f64 { self.value }
#[getter]
fn initialized(&self) -> bool { self.initialized }
#[getter]
fn has_inputs(&self) -> bool { self.has_inputs }
}
See crates/indicators/src/ for the full Rust indicator library. All built-in indicators have Rust implementations that are exposed to Python via PyO3.
Custom Statistics in Rust
Portfolio statistics can also be implemented in Rust for performance. See crates/analysis/src/statistics/ for examples (Sharpe ratio, Sortino, max drawdown, etc.).
PyO3 Binding Conventions
- Use
#[pyclass]and#[pymethods]for Python-visible types - Register new modules in
crates/pyo3/src/lib.rs - Use
#[getter]for read-only properties - Wrap FFI functions in
abort_on_panic(|| { ... })— panics must never unwind across FFI
Key Conventions
Indicator Naming
- Match NT convention:
ExponentialMovingAveragenotEMA(class name) - Short names used in
nameproperty (auto-derived) - Parameters passed to
super().__init__(params=[...])for serialization
Registration Pattern
Always register indicators via self.register_indicator_for_bars() or self.register_indicator_for_quote_ticks() in on_start() — never call handle_bar() manually.
Custom Data Serialization
@customdataclassauto-generates Arrow schemasInstrumentIdfields are auto-converted to/from strings- All fields need type annotations
ts_eventandts_initare auto-prepended (don't define them)
References
references/concepts/— reports, visualization, portfolio, datareferences/api/— indicators, analysis, data, book, portfolioreferences/python/— analysis source reference (config, tearsheet, statistic, themes)references/rust/— analysis Rust source referencereferences/examples/— indicator usage, cascaded indicators, bar aggregationtemplates/— indicator.py, custom_data.py, portfolio_statistic.py
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |