Skip to main content

AlgoTradeKit

AlgoTradeKit is a modular Python library for building, backtesting, and live-trading algorithmic strategies. Every indicator is implemented from scratch — no pandas-ta, no ta-lib — so you have full control over every calculation.

pip install AlgoTradeKit

Requires Python 3.10+

Runnable examples live in examples/. Each one downloads a little public Binance data and needs no exchange key; 01–03 fall back to synthetic candles offline. 04–08 send to your own Telegram bot and 09 to Discord, e-mail or a webhook, and each says what to set when it needs it:

python examples/01_backtest_report.py          # backtest → chart + report
python examples/02_chart_timeframes_replay.py  # timeframe switching + bar replay
python examples/03_multi_chart_page.py         # three synced charts on one page
python examples/04_telegram_messages.py        # text to your Telegram (needs TELEGRAM_BOT_TOKEN)
python examples/05_telegram_paper_alerts.py    # paper trading's signals to Telegram (same)
python examples/06_telegram_chart_picture.py   # a chart picture to Telegram (same, and the [notify] extra)
python examples/07_price_alerts.py             # price alerts to Telegram (same)
python examples/08_telegram_commands.py        # /status, /positions, /stop from Telegram (same)
python examples/09_other_backends.py           # Discord, e-mail, a webhook (their own variables)

🔔 New in v1.2.0 — notifications

Your strategy's trades, a picture of the chart with each, price alerts and a backtest's report, sent to Telegram, and commands back from your phone:

from AlgoTradeKit import run_live
from AlgoTradeKit.broker import Broker
from AlgoTradeKit.notify import TelegramNotifier
from AlgoTradeKit.trader import TraderConfig

bot = TelegramNotifier(token, {"me": 123456789},   # your private chat with the bot
                       images={"open", "close"},   # chart pictures: the [notify] extra
                       commanders=[123456789])     # /status, /chart, /stop from your phone
config = TraderConfig(symbol="BTCUSDT", min_candles=200, notifiers=[bot])
run_live(strategy=MyStrategy(), broker=Broker("binance-spot"), config=config)
  • Trading events — signals, opens, closes, the start, the stop and the day, from run_live and Trader alike. A trade's messages reply to its first one, and trading never waits for a message.
  • Chart pictures on trade messages, or on demand with send_chart and send_report.
  • Price alerts with no strategy: bot.watch(broker, "BTCUSDT", above=65_000).
  • Commands: /status, /positions, /chart, /stop and /help.
  • Discord, e-mail and webhooks get the same messages.

See notify.

v1.1.0 grew the chart: timeframe switching, several synced charts on one page, and bar replay. See visual.

v1.0.0 brought live trading: Trader for real orders, run_live() for paper trading on live data, both sharing the backtest's own position maths. See trader.


Table of Contents

  1. Architecture Overview
  2. broker — Exchanges & MetaTrader
  3. data — OHLCV Collection
  4. indicator — Technical Indicators
  5. strategy — Signal Generation
  6. simulate — Backtesting Engine
  7. trader — Live Trading
  8. notify — Notifications
  9. visual — Interactive Chart
  10. report — Simulation Report
  11. Built-in MACD Strategy Demo
  12. Configuration Reference

Architecture Overview

AlgoTradeKit/
├── broker/         Unified exchange & MetaTrader access — candles, orders, account, sockets  ← v0.9.0
├── data/           Download and cache OHLCV candles (via the broker module)
├── indicator/      RSI, MACD, EMA, SMA, ATR, Ichimoku — all with O(1) streaming updates
├── strategy/       BaseStrategy, Signal, StrategyResult, built-in strategies
├── simulate/       Backtesting engine, position management, SimulateReport
├── trader/         Live trading — real orders and run_live paper trading  ← v1.0.0
├── notify/         Telegram, Discord, e-mail and webhook notifications  ← new in v1.2.0
├── visual/         Interactive candlestick chart served in your browser
└── report/         Interactive simulation report web page  ← v0.7.0

Data flows in one direction:

broker ──► data ──► indicator ──► strategy ──► simulate ──► report
                                       │           └──────► visual
                                       └──────► trader ◄────┘
                                                  └──────► notify

trader is a leaf: it consumes broker, strategy and simulate, and nothing imports from it. That is what keeps the backtest engine free of live-trading concerns while both share the same position maths. trader hands its events to notify, which imports no other module when it is imported: a broker reaches it as an object, and the chart and the report load only to make a picture.


broker — Exchanges & MetaTrader (v0.9.0)

One unified door to every venue. Create a connection with Broker(...) and hand the result to data.Collector (candles / streaming) or use it directly for account info and orders. A Binance spot account, a Binance USD-M futures account, and a MetaTrader forex account all expose the same BaseBroker interface — the connector hides each venue's quirks.

Market data — no credentials needed:

from AlgoTradeKit.broker import Broker

b = Broker("binance-futures")                       # public: no API keys
candles = b.fetch_last_candles("BTCUSDT", "1h", 500)  # list of standard candle dicts
tick    = b.get_ticker("BTCUSDT")                     # last / bid / ask

Trading — credentials required (testnet=True for the sandbox):

b = Broker("binance-futures", api_key="…", api_secret="…", testnet=True)

b.set_leverage("BTCUSDT", 10)
res = b.create_market_order("BTCUSDT", "buy", 0.001,
                            stop_loss=58000, take_profit=72000)  # SL/TP = reduce-only orders
print(b.open_positions(), b.get_account_info().equity)
b.close_position("BTCUSDT")

Order placement is safe-by-default in the sense that private calls need explicit credentials; live endpoints are the default and testnet=True opts into the sandbox.

Real-time streams — every venue, one API:

stream = b.stream_candles("BTCUSDT", "1m", lambda c: print(c["close"]), closed_only=True)
# … later …
stream.stop()

Binance streams over WebSocket. MetaTrader has no push feed, so (v1.0.0) it polls the terminal behind the same Stream handle and emits the same candle dicts — closed candles fire exactly once, in order.

Trading costs & venue clock (v1.0.0)

costs = b.get_trading_costs("BTCUSDT")
costs.commission, costs.commission_type, costs.spread, costs.contract_size

b.clock_offset_ms()      # venue clock − local clock (median-sampled, cached)

Binance reports your account's real taker fee and a live book spread; MetaTrader reports spread and contract size from symbol_info. The live trader uses both to size positions correctly and to fire exactly on candle close.

MetaTrader (forex) — Windows and Linux (v1.0.0)

MetaTrader has no public API: the terminal speaks a proprietary protocol to your broker's server. AlgoTradeKit picks the right transport automatically.

mt = Broker("metatrader", server="MyBroker-Demo", login=12345678, password="***")
print(mt.mode)   # "native" on Windows, "bridge" on Linux/macOS

candles = mt.fetch_last_candles("EURUSD", "15m", 1000)
mt.create_market_order("EURUSD", "buy", 0.10, stop_loss=1.0800, take_profit=1.1000)
Where you run Transport Setup
Windows in-process MetaTrader5 pip install AlgoTradeKit[mt5] + the terminal installed and logged in once
Linux / macOS Wine bridge over TCP MT5_WINE_SETUP.md
any OS, remote host= that host's bridge bridge running on the VPS

Force it with mode="native" / mode="bridge" if you ever need to. Both transports run the same operation implementations, so behaviour is identical.

MetaTrader5 is never a core dependency — on Windows it is the opt-in [mt5] extra (marker-gated so it can never install on Linux), and on Linux it lives only inside the Wine Python. No dependency conflict either way.

When a bridge connection fails, the error names the failing step and the exact setup section that fixes it — Wine missing, prefix missing, or bridge not running — then stops. No silent fallback.

📘 Headless Linux setup: MT5_WINE_SETUP.md. Install Wine + Xvfb, run the bridge, SSH-tunnel the port, plus a Windows section, an error-message reference table and troubleshooting.


data — OHLCV Collection

The data module now sits on top of broker. Collector takes either a venue name or a ready Broker instance:

from AlgoTradeKit.data import Collector
from AlgoTradeKit.broker import Broker

# way 1 — by name (Collector builds the connector)
c = Collector("binance-futures", "BTCUSDT", "1h")

# way 2 — bring your own Broker (e.g. authenticated, or a MetaTrader forex link)
c = Collector(Broker("metatrader", server="MyBroker-Demo", login=1, password="…"),
              "EURUSD", "15m")

# real-time candles for either venue
stream = c.stream(lambda candle: print(candle["close"]))
from AlgoTradeKit.data import Collector

collector = Collector(
    exchange="binance_futures",
    symbol="BTCUSDT",
    timeframes=["1h", "4h"],
    save_dir="data/",
)
data = collector.fetch(start="2024-01-01", end="2024-12-31")
# data["1h"] → pd.DataFrame  columns: timestamp(UTC ms), open, high, low, close, volume

Load from an existing CSV:

import pandas as pd
data = {"1h": pd.read_csv("data/binance-futures_BTCUSDT_1h.csv")}

Normalizing non-standard CSVs (v0.7.2)

Broker / MT5 exports often use Unix-second timestamps and omit optional columns. Normalizer converts any OHLCV CSV to the library standard automatically:

from AlgoTradeKit.data import Normalizer

# Accepts: timestamp in seconds OR milliseconds (auto-detected)
# Required columns: timestamp, open, high, low, close
# Optional: volume (defaults to 0 if absent)
norm = Normalizer("USDJPY_1m.csv")
norm.start = "2022/01/01"   # optional date filter
norm.end   = "2024/01/01"

# Return as DataFrame (no file written)
df = norm.normalize()

# Save as library-standard CSV
path = norm.save(destination="data/")

# One-liner: normalize + save
df, path = Normalizer("USDJPY_1m.csv").normalize_and_save(destination="data/")

Resampling in memory (v1.1.0)

Converter writes CSVs; when you just want the candles, the same maths is a plain function:

from AlgoTradeKit.data import resample_ohlcv, detect_timeframe, can_convert

detect_timeframe(df)                # "1m"
resample_ohlcv(df, "5m")            # -> DataFrame, timestamp in UTC ms
resample_ohlcv(df, "5m", drop_incomplete=False)   # keep the candle still forming
can_convert("4h", "6h")             # False — not a whole multiple

No printing, no files, and the input frame is never modified. This is what the chart's timeframe switching runs on, so a resample you do yourself and one the chart does are the same numbers.


indicator — Technical Indicators

All indicators are built from scratch — no third-party TA wrappers.

from AlgoTradeKit.indicator import ATR, RSI, MACD, EMA, SMA, Ichimoku

close = df["close"]   # pd.Series

rsi  = RSI(close, length=14)           # rsi.rsi
macd = MACD(close, fast=12, slow=26, signal=9)
                                        # macd.macd, .signal, .histogram
ema  = EMA(close, length=20)           # ema.ema
sma  = SMA(close, length=50)           # sma.sma
atr  = ATR(df["high"], df["low"], close, period=14)  # atr.atr, atr.tr
ichi = Ichimoku(df["high"], df["low"], close)
                                        # ichi.tenkan / kijun / senkou_a / senkou_b
                                        # ichi.chikou / cloud_future_a / cloud_future_b
                                        # ichi.span_a_raw / span_b_raw  ← v0.7.2

ATR — Average True Range (v0.7.2)

Wilder's smoothing (RMA, alpha = 1/period). Matches TradingView ta.atr().

atr = ATR(df["high"], df["low"], df["close"], period=14)
df["atr"] = atr.atr.values   # Wilder-smoothed ATR
df["tr"]  = atr.tr.values    # raw True Range

Ichimoku.span_a_raw / .span_b_raw (v0.7.2)

Unshifted Senkou Span A and B (at the current bar, before the displacement shift is applied). Useful in strategy logic where you need the live cloud value:

ichi = Ichimoku(high, low, close, displacement=26)
# ichi.senkou_a   = span_a_raw.shift(26)  — displayed cloud (forward-shifted)
# ichi.span_a_raw = (tenkan + kijun) / 2  — current bar value (unshifted)

Streaming updates (v1.0.0)

Every indicator can consume one new bar at a time — O(1), no recompute:

ema = EMA(close, length=20)
ema.update(new_close)                     # -> float
macd.update(new_close)                    # -> {"macd", "signal", "histogram"}
atr.update(new_high, new_low, new_close)  # -> float
ichi.update(new_high, new_low, new_close) # -> {"tenkan", "kijun", ...}

The stored source and result series are extended in place, so properties and crossover helpers stay correct afterwards. Values are parity-tested against the batch computation for all 13 indicator classes — streaming and batch agree.


strategy — Signal Generation

Subclass BaseStrategy, implement two methods, and return Signal objects.

from AlgoTradeKit.strategy import BaseStrategy, Signal, StrategyMode

class EMAStrategy(BaseStrategy):

    def prepare_indicators(self, data):
        df = data["1h"].copy()
        df["ema20"] = EMA(df["close"], 20).value
        return {**data, "1h": df}

    def generate_signals(self, data):
        df, signals = data["1h"], []
        for i in range(1, len(df)):
            r, p = df.iloc[i], df.iloc[i - 1]
            if p["close"] < p["ema20"] and r["close"] >= r["ema20"]:
                signals.append(Signal(
                    direction="long",
                    entry_price=r["close"],
                    stop_loss=r["close"] * 0.98,
                    take_profit=r["close"] * 1.04,
                    timestamp=int(r["timestamp"]),
                    candle_index=i,
                    timeframe="1h",
                ))
        return signals

result = EMAStrategy().run(data, mode=StrategyMode.BACKTEST)

Strategy Drawings (v0.7.0)

Strategies can attach visual drawings so they appear on the candle chart:

# In generate_signals or prepare_indicators:
self._drawings.append({
    "type": "hline", "price": 42000.0,
    "color": "#58a6ff", "label": "Support",
})

# Return them in StrategyResult:
return StrategyResult(..., drawings=self._drawings)

Live / Incremental Computation (v1.0.0)

A live session must not recompute the whole history every candle. Add an optional hook and each new candle costs O(1):

class MyStrategy(BaseStrategy):

    def setup(self, data):
        self.zones = []          # custom state lives here, not in prepare_indicators

    def update_indicators(self, data, new_index):
        """Called exactly once per closed candle, after the row is appended."""
        df = data[self.primary_timeframe]
        df.loc[new_index, "_ema20"] = self._ema.update(df.loc[new_index, "close"])
        self.zones = self._rebuild_zones(df, new_index)   # any custom state too

The hook is optional. Without it the library falls back to recomputing prepare_indicators over the last K candles and splicing the _-prefixed columns back — accurate for windowed indicators, and never revising a value it already wrote. Implement the hook if your strategy repaints or builds Python objects (order blocks, zones, SMC structures) during prepare_indicators.

Built-in Strategies

Strategy Import
MACD Crossover from AlgoTradeKit.strategy.builtin.macd import MACDCrossoverStrategy
from AlgoTradeKit.strategy.builtin.macd import MACDCrossoverStrategy

strategy = MACDCrossoverStrategy(fast=12, slow=26, signal=9,
                                  sl_atr_multiplier=1.5, timeframe="1h")
result = strategy.run(data)

simulate — Backtesting Engine

Replay StrategyResult signals candle-by-candle and produce a SimulateReport.

Basic Usage

from AlgoTradeKit.simulate import Simulate, SimulateConfig

config = SimulateConfig(
    initial_balance=10_000,
    symbol="btcusdt",
    leverage=10,
    commission=0.001,         # 0.1% per side
    risk_per_trade=1.0,       # 1% of balance at risk
    tp_mode="fixed_rr",
    tp_rr=2.0,
    primary_timeframe="1h",
)
report = Simulate(config).run(strategy_result)
print(report)

Auto Visualisation (v0.7.0)

config = SimulateConfig(
    ...
    show_chart=True,          # open candle chart with position boxes
    report_mode="both",       # "none" | "webpage" | "save" | "both"
    report_save_path="report.html",
)
report = Simulate(config).run(strategy_result)
# → two browser tabs open: candle chart and report page
# → report.html saved to disk

SimulateConfig Key Fields

Field Default Description
initial_balance 10 000 Starting wallet balance
leverage 1.0 Leverage multiplier
commission 0.001 0.1% per side (percentage mode)
risk_per_trade 1.0 % of balance at risk per trade
tp_mode "signal" "signal"/"fixed_rr"/"multi_rr"/"none"
tp_rr 2.0 R:R ratio for fixed_rr mode
tp_levels [1,2,3] R levels for multi_rr mode
tp_level_close_fractions None v0.7.3 Fraction of original size to realise at each tp_levels entry (multi_rr only) — see below
sl_mode "signal" "signal" or "trailing"
risk_free_enabled False Move SL to break-even at risk_free_at_rr
show_chart False v0.7.0 Open candle chart after run
report_mode "none" v0.7.0 Post-run report rendering
report_save_path "report.html" v0.7.0 HTML save path
chart_indicators [] v0.8.0 Indicator specs drawn on the show_chart chart (backend-computed) — see below

Per-Signal Sizing & Partial Take-Profit (v0.7.3)

Signal.risk_multiplier scales one signal's size relative to the run's sizing config — useful for varying risk by context, or for splitting one trade idea into several sub-positions whose sizes sum to one risk unit:

# Three signals at the same candle, each risking 1/3 of a normal trade,
# targeting 1R / 2R / 3R — equivalent to scaling out of one position.
for i, tp_r in enumerate([1, 2, 3], start=1):
    signals.append(Signal(
        direction="long", entry_price=entry, stop_loss=sl,
        take_profit=entry + tp_r * (entry - sl),
        timestamp=ts, candle_index=idx, timeframe="1h",
        risk_multiplier=1 / 3,
    ))

SimulateConfig.tp_level_close_fractions turns multi_rr into a true scale-out — each level realises a real, partial close instead of only moving the SL:

config = SimulateConfig(
    ...,
    tp_mode="multi_rr",
    tp_levels=[1.0, 2.0, 3.0],
    tp_level_close_fractions=[1 / 3, 1 / 3, 1 / 3],  # bank 1/3 at each level
)

Set every fraction to 0.0 instead to get the opposite pattern — SL walks through every level but nothing closes until the position is eventually stopped out, letting winners run with a trailing stop and no fixed target.

Batch Sweep

from AlgoTradeKit.simulate import run_batch

reports = run_batch(strategy, data, [
    SimulateConfig(tp_rr=1.5),
    SimulateConfig(tp_rr=2.0),
    SimulateConfig(tp_rr=3.0),
])
best = max(reports, key=lambda r: r.sharpe_ratio)

Multi-Pair Portfolio

from AlgoTradeKit.simulate import run_multi

report = run_multi([
    (btc_strategy, btc_data, SimulateConfig(symbol="btcusdt")),
    (eth_strategy, eth_data, SimulateConfig(symbol="ethusdt")),
], initial_balance=10_000)

Candle-by-Candle Stepping (v1.0.0)

The engine core is also usable one candle at a time — the batch loop is a thin driver over it, so results stay byte-identical:

from AlgoTradeKit.simulate import SimulationStepper

stepper = SimulationStepper(config)
for candle in feed:                                  # broker stream dicts work as-is
    closed = stepper.step(candle, signals=sigs)      # -> trades closed this candle
    snapshot = stepper.build_report()                # any-time report snapshot
stepper.finalize()                                   # close leftovers at the last close

LiveSimulation builds on it: seed history → simulate → keep stepping a live feed, pushing chart and report updates each closed candle. It is what powers run_live() and the trader's display, and it never places an order.

SimulateReport

report.total_pnl          # float
report.win_rate           # float (%)
report.profit_factor      # gross profit / gross loss
report.sharpe_ratio       # annualised Sharpe
report.sortino_ratio
report.calmar_ratio
report.max_drawdown       # DrawdownPeriod
report.significant_drawdowns  # list[DrawdownPeriod]
report.weekday_stats      # dict[str, WeekdayStats]
report.session_stats      # dict[str, SessionStats]  (London/NY/Tokyo/Sydney)
report.monthly_stats      # dict[str, MonthStats]
report.balance_history    # list[dict]
report.trade_markers      # list[dict]

trader — Live Trading (v1.0.0)

Two entry points, one config class. run_live() paper-trades on live market data; Trader places real orders. Both take the same TraderConfig, whose field names mirror SimulateConfig — a tuned backtest config copy-pastes across.

Paper Trading — run_live()

Watch a strategy trade the current market without opening a position. Order code is never even imported; the simulation engine fills the trades, with the venue's real costs applied.

from AlgoTradeKit.broker import Broker
from AlgoTradeKit.trader import TraderConfig, run_live

config = TraderConfig(
    symbol="BTCUSDT",
    min_candles=500,          # history the strategy needs before it may trade
    risk_per_trade=1.0,
    tp_mode="multi_rr",
    tp_levels=[1.0, 2.0, 3.0],
    display=True,             # live chart + live report
    display_candles=1000,     # seed the display with the last 1000 candles
    log_events=True,          # per-event terminal log
)

report = run_live(strategy=MyStrategy(),
                  broker=Broker("binance-futures"),
                  config=config)

Blocks until Ctrl+C, then returns the final SimulateReport.

Real Orders — Trader

from AlgoTradeKit.trader import Trader

trader = Trader(
    broker=Broker("binance-futures", api_key="…", api_secret="…"),
    strategy=MyStrategy(),
    config=config,
    state_path="trader_state.json",     # journal for restart recovery
    kill_switch_file="STOP",            # touch this file to shut down
    on_stop="keep",                     # or "close_all"
)
trader.run()          # blocks; Ctrl+C / SIGTERM shut down gracefully

Stop-losses are always venue-native. SL and TP are attached to the real order, and trailing / risk-free / multi-RR moves modify the venue SL. There is no soft stop watching price in Python anywhere — if your process dies, your stop is still on the exchange.

What it does for you

Execution modes candle_close (fires at the exact venue-clock boundary — never late, even when the venue prints no candle until its first trade), candle_update, tick
Position management Trailing SL, risk-free moves and multi-RR ladders, all from the same maths the backtest uses
Multi-RR ladders Venue-native: reduce-only level orders on Binance futures, feed-detected partial closes on MetaTrader
Safety max_daily_loss (500 or "2%") halts new entries for the UTC day, optional flatten; kill-switch file; graceful shutdown
Restart recovery State is journaled on every change and reconciled against the venue on start — open positions are adopted with their trailing/ladder state, offline closes are recovered from venue history, foreign positions are left untouched
Multi-pair One worker per pair, brokers may repeat, one combined report

Event Log

Every meaningful moment is a typed event on a stream, printed as one grep-able line (log_events=True, filter with log_event_types):

2026-10-14 12:41:07 [LIVE] START live BTCUSDT
2026-10-14 12:00:00 [LIVE][BTCUSDT] SIGNAL long @ 64250 sl=63800 tp=65150 risk=$100 rr=2.00 tf=1h
2026-10-14 12:00:00 [LIVE][BTCUSDT] OPEN #12 long filled @ 64251.5 size=0.2222 margin=$1427.8 risk=$100 sl=63800 next_tp=65150 order=8412739921
2026-10-14 13:00:00 [LIVE][BTCUSDT] SL_MOVE #12 sl 63800 -> 63950 (trailing) next_tp=65150
2026-10-14 14:00:00 [LIVE][BTCUSDT] RISK_FREE #12 rr=1.00 touched, sl 63950 -> 64251.5 (break-even)
2026-10-14 15:00:00 [LIVE][BTCUSDT] MESSAGE RSI back under 70
2026-10-14 15:00:00 [LIVE][BTCUSDT] CLOSE #12 @ 65150 reason=tp gross=$199.66 net=$185.37 r=1.85 duration=3h 41m
2026-10-14 18:07:44 [LIVE] STOP Ctrl+C open=0

[SIM] tags paper trades, [LIVE] real ones. A candle's events carry the candle's opening time; START and STOP carry the moment they happened. The same stream feeds the notifiers in TraderConfig(notifiers=[…]): see notify.

Multi-Pair / Multi-Venue

from AlgoTradeKit.trader import Trader, TraderPair

trader = Trader(pairs=[
    TraderPair(broker=binance, config=cfg_btc, strategy=StratA()),
    TraderPair(broker=mt5,     config=cfg_eur, strategy=StratB()),
    TraderPair(broker=mt5,     config=cfg_gbp, strategy=StratB()),
])
trader.run()

Pairs on the same broker share that account's wallet naturally. Every pair gets its own chart, report and event log, plus one combined portfolio report — merged trades, equity summed across accounts, per-pair breakdown.

Live Display

Optional and off by default — display work runs on a low-priority background queue, so it can never slow the trading loop.

TraderConfig(
    display=True,
    display_trades="sim",           # "sim" | "real" | "both"
    display_open_browser=False,     # VPS: print the URLs instead of opening tabs
    chart_host="0.0.0.0",           # reachable from another machine
    chart_port=8080, report_port=8081,
    candle_count_limit=2000,        # rolling window keeps memory bounded
)

"sim" shows theoretical strategy performance, "real" shows your actual fills, "both" overlays them.


notify — Notifications (v1.2.0)

Send text, chart pictures, a trading session's events, price alerts and a backtest's report to Telegram, and to Discord, e-mail or a webhook of your own. Each notifier keeps its own queue on its own thread, so trading never waits for a message. It paces itself to the service's limits, retries after an error, waits out an outage, and marks what arrives late.

pip install AlgoTradeKit               # text needs nothing more
pip install "AlgoTradeKit[notify]"     # chart pictures (Playwright) and a SOCKS proxy
playwright install chromium            # once, for pictures; on Linux: --with-deps, as root

Telegram in five minutes

  1. In Telegram, open @BotFather, send /newbot, and copy the token it gives you. The token is a password: keep it in the environment (read -rs TELEGRAM_BOT_TOKEN && export TELEGRAM_BOT_TOKEN), never in a file.
  2. Open your bot (t.me/<its username>) and press Start: a bot cannot write to someone who never did. For a group, add the bot to it. For a channel, make the bot an administrator with «Post messages».
  3. Write something in each chat, list the chats the bot has seen, and send:
import os
from AlgoTradeKit.broker import Broker
from AlgoTradeKit.notify import TelegramChat, TelegramNotifier

token = os.environ["TELEGRAM_BOT_TOKEN"]
for chat in TelegramNotifier.find_chats(token):
    print(chat.id, chat.kind, chat.title)       # 123456789 private Ann, -1001234567890 channel …

bot = TelegramNotifier(token, {
    "me": 123456789,                                        # your private chat with the bot
    "signals": TelegramChat(-1001234567890, silent=True),   # a channel, without sound
})
bot.send_text("Hello from AlgoTradeKit")                    # to every chat
bot.send_text("{header}\nwatching the 64k level", to="me",
              symbol="BTCUSDT", broker=Broker("binance-spot"))
# → «🕑 2026-10-14 14:03 UTC · BTCUSDT 64,312.5» and «watching the 64k level»

The bot checks its token and every chat when it is created, and says what to fix. A text may use {time}, {date}, {symbol}, {price} (the last price, from broker.get_ticker) and {header}, the ready-made first line above. Times are UTC unless the notifier gets timezone="Asia/Tehran", and HTML is on (<b>…</b>). Besides silent=, a TelegramChat takes a forum topic (thread_id=) and two filters: the kinds of message it gets (events=) and its symbols=. Where Telegram is blocked, pass proxy="http://127.0.0.1:10809", or "socks5h://127.0.0.1:10808" with the [notify] extra.

Trading events

config = TraderConfig(symbol="BTCUSDT", min_candles=200, notifiers=[bot])
run_live(strategy=MyStrategy(), broker=Broker("binance-spot"), config=config)   # or Trader

run_live and Trader send the same messages, tagged SIM or LIVE on their 🕑 line:

Kind Sent when First line
start, stop the session starts; it stops (Ctrl+C, /stop, the kill switch, a crash) «▶️ Paper trading started · BTCUSDT», «⏹ Paper trading stopped · BTCUSDT · Ctrl+C · …»
signal the strategy gives one «🟢 LONG BTCUSDT · 1h», then entry, SL, TP and RR
open a trade opens «✅ OPENED #12 · LONG BTCUSDT @ 64,251.5», then size, risk, SL, next TP
sl_move the stop moves — not sent unless a chat asks for it an edit of the open message
risk_free, tp_level the stop goes to break-even; a take-profit level fills «🛡 RISK-FREE #12 …», «🎯 TP 1 R #12 …»
close the trade ends «🏁 CLOSED #12 · LONG BTCUSDT @ 65,150 — take profit», then net, R, how long
exit_signal, daily_loss, reconcile, error as their events in the log «🚪 EXIT SIGNAL …», «⛔ DAILY LOSS LIMIT …», «🔄 RESTART RECONCILED …», «⚠️ ERROR …»
message the strategy calls self.notify("RSI back under 70") on a live candle «💬 BTCUSDT · 1h»
daily_summary 00:00 in the notifier's zone «📊 DAY 2026-10-14 · BTCUSDT», trades, won, lost, net

A trade's messages form a thread: its risk-free move, its TP levels and its close reply to its open. In a chat that takes sl_move, each move of the stop edits the open message, whose line «SL 63,800 → 63,950 (trailing) · 14:00» changes, instead of sending a new one. A chat picks its kinds with events=:

bot = TelegramNotifier(token, {
    "me": TelegramChat(123456789, events={"signal", "open", "sl_move", "close", "stop"}),
    "followers": TelegramChat("@my_signals", events={"signal", "close"}),
})

A channel that takes no opens gets each close as a reply to its signal. A signal goes out as the strategy gives it, whether or not it opens a trade: with max_positions=1, a signal that comes while a trade is open opens nothing. A channel that should show only what was traded takes events={"open", "close"}. templates={"close": "…"} replaces a kind's default text, with the event's own fields as placeholders, and {"close": None} sends none. A price the simulation works out, such as a trailing stop or a take profit from the RR, keeps all its decimals in a paper session («81,821.078995»).

self.notify(text) speaks only from a live run, and only on a newly closed candle. In a backtest, during the seed and on a forming candle it does nothing.

Pictures

bot = TelegramNotifier(token, chats, images={"open", "close"})   # a chart on those messages
bot.send_chart(broker=Broker("binance-spot"), symbol="BTCUSDT", timeframe="15m",
               start="2026-10-14 08:00", end="2026-10-14 14:00",
               indicators=[{"kind": "ema", "period": 20}], caption="<b>BTCUSDT · 15m</b>")
bot.send_chart(chart, start, end)    # a Chart you built, its indicators and drawings included
bot.send_photo(png_bytes, caption="my own picture")
bot.send_report(report)              # a backtest: its figures, the balance curve, report.html

A picture of the open shows the last 100 candles with the entry, the SL and the next TP; the close shows the whole trade with its position box. A caption longer than Telegram's 1,024 characters goes on in a reply. Pictures need the [notify] extra and its Chromium. A headless Chromium photographs the library's own chart page, on the notifier's thread, and stays open while the notifier lives: about 450 MB idle.

Price alerts

binance = Broker("binance-spot")
alert = bot.watch(binance, "BTCUSDT", above=65_000)             # once
bot.watch(binance, "BTCUSDT", below=60_000, image=True)          # with a picture of the levels
bot.watch(binance, "BTCUSDT", move_pct=-3, window="1h")          # a 3% fall within the hour
bot.watch(binance, "BTCUSDT", above=66_000, on_close="1h")       # on a closed 1h candle
bot.watch(binance, "ETHUSDT", above=2_500, repeat=True, rearm=0.2)   # each time, once 0.2% back
bot.wait()                                                       # until none is armed, or Ctrl+C

«🔔 BTCUSDT crossed above 65,000 · now 65,012.5», with no strategy and no trading. bot.alerts() lists them, with each one's condition, state and fired count, and alert.cancel() ends one. An alert follows the last trade: the forming candle's close. On Binance, stream_ticker gives the order book's middle instead, and get_ticker the last trade.

Commands

bot = TelegramNotifier(token, {"me": 123456789}, commanders=[123456789])

The people in commanders= can ask for /status (what is trading, since when, today's net, the open positions), /positions, /chart [SYMBOL] [TF], /stop and /help, in any chat they write in, and get replies. Anyone else is refused. A person's id is the id of their private chat with the bot.

  • /stop ends the run_live session or the Trader the bot serves, as Ctrl+C does. Live trading first asks for /stop CONFIRM, within 60 s.
  • In a group, Telegram's privacy mode passes on only commands that name the bot: /status@your_bot.
  • Commands sent while nothing listened are skipped, not run late.
  • One program listens per bot. A second one gets Telegram's 409 Conflict and says so, and find_chats beside a listener lists what that listener saw.

Discord, e-mail and webhooks

from AlgoTradeKit.notify import DiscordNotifier, EmailNotifier, WebhookNotifier

discord = DiscordNotifier({"desk": os.environ["DISCORD_WEBHOOK_URL"]})
mail = EmailNotifier("smtp.gmail.com", {"me": "you@gmail.com"},
                     username="you@gmail.com", password=os.environ["SMTP_PASSWORD"])
hook = WebhookNotifier({"mine": "https://example.com/hook"},
                       secret=os.environ["WEBHOOK_SECRET"])
config = TraderConfig(symbol="BTCUSDT", min_candles=200, notifiers=[bot, discord, mail, hook])

They take the same kinds, filters, templates and pictures, and work wherever a Telegram bot does: notifiers=[…], send_text, send_chart, send_report and watch. What a service cannot do degrades. Discord cannot reply, so a close is a plain message. E-mail cannot edit, so a stop's move, for a recipient who takes it, is a message of its own. A webhook does neither. Commands stay Telegram's.

  • Discord: a channel's webhook URL, from the channel's settings: Integrations, Webhooks, New Webhook, Copy Webhook URL. The URL holds the webhook's token, so keep it as a password. Messages use Discord's Markdown.

  • E-mail: any SMTP server: port 587 takes STARTTLS (the default) and 465 SSL. Gmail needs an app password, made in your Google account once 2-Step Verification is on, and sends about 500 e-mails a day. Each e-mail is HTML with a plain-text part, its subject the message's first line, pictures inline. A recipient's trade messages wait for a digest, one e-mail every 15 minutes (digest_minutes=; 0 sends each on its own). The start, the stop, texts and alerts go at once.

  • A webhook: each message is a POST of JSON to your URL:

    {"id": "8f3c…", "kind": "close", "symbol": "BTCUSDT", "time": 1792001700123,
     "source": "SIM", "text": "🏁 CLOSED #12 · …", "html": "<b>🏁 CLOSED #12 · …</b>…",
     "silent": false, "fields": {"trade_id": 12, "net_pnl": 200.0, "pnl_r": 2.0, …},
     "late_seconds": 0}
    

    fields holds the event's raw values: numbers as numbers, times in UTC ms. id is the same on every try, so a receiver can drop a repeat. With a picture the body is multipart/form-data: this JSON as payload_json, and the PNG as file. With secret=, each request carries X-AlgoTradeKit-Timestamp (Unix seconds) and X-AlgoTradeKit-Signature, which a receiver checks:

    import hashlib, hmac
    
    def signed(secret: bytes, timestamp: str, payload: bytes, signature: str) -> bool:
        """payload: the body, or with a picture the payload_json field."""
        expected = hmac.new(secret, timestamp.encode() + b"." + payload, hashlib.sha256)
        return hmac.compare_digest(signature, "sha256=" + expected.hexdigest())
    

    Refuse a timestamp more than a few minutes old as well: a signature alone does not stop a request from being sent again.


visual — Interactive Chart

Interactive candlestick chart served locally, based on TradingView's lightweight-charts.

from AlgoTradeKit.visual import Chart

chart = Chart.from_csv("data/binance-futures_BTCUSDT_1h.csv")
chart.show(block=True)

Candle range filter (v0.7.2)

Restrict which candles are visible without modifying the source data:

# Show a specific datetime range
chart = Chart.from_csv("data/btc_1h.csv",
    candle_range={"start": "2024/01/01", "end": "2024/06/01"})

# From a date to the last candle
chart = Chart.from_csv("data/btc_1h.csv",
    candle_range={"start": "2024/06/01"})

# From the first candle to a date
chart = Chart.from_csv("data/btc_1h.csv",
    candle_range={"end": "2024/01/01"})

# Last / first N candles
chart = Chart.from_csv("data/btc_1h.csv", candle_range={"last_n": 500})
chart = Chart.from_csv("data/btc_1h.csv", candle_range={"first_n": 200})

# Also available on set_data()
chart.set_data(df, candle_range={"start": "2023/01/01", "end": "2024/01/01"})

Add Indicators

from AlgoTradeKit.visual import add_rsi, add_macd, add_ma, add_ichimoku
from AlgoTradeKit.indicator import RSI, MACD, EMA, Ichimoku

add_rsi(chart,  RSI(df["close"]),             timestamps=df["timestamp"])
add_macd(chart, MACD(df["close"]),            timestamps=df["timestamp"])
add_ma(chart,   EMA(df["close"], 20),         timestamps=df["timestamp"], name="EMA 20")
add_ichimoku(chart, Ichimoku(df["high"], df["low"], df["close"]),
                              timestamps=df["timestamp"])

Drawings

chart.add_hline(price=42_000, label="Support")
chart.add_box(time1=1700000000, price1=41_000,
              time2=1700007200, price2=43_000, opacity=0.1)
chart.add_signal(time=1700000000, side="buy")

Position Boxes (v0.7.0)

TradingView-style position boxes showing SL/TP zones with R:R labels:

from AlgoTradeKit.visual.indicator_renderer import add_simulation_positions

chart = Chart.from_csv("data/binance-futures_BTCUSDT_1h.csv")
add_simulation_positions(chart, report, opacity=0.15, config=sim_config)
chart.show(block=True)

Dynamic SL/TP lines (v0.7.4) — when config is passed, coloured horizontal lines are drawn on the chart for every trade where the SL moved:

Colour Meaning
🔴 Red SL is in the loss zone (below entry for long)
🟡 Amber SL is at break-even (entry price)
🔵 Cyan SL is in profit territory
🟢 Green Next TP target (multi_rr only)

The position box's profit-zone boundary is also corrected to show the TP target that was active at the moment of closing rather than the initial TP at entry. For trailing-SL trades the box top is set to peak_price (the highest price the trailing SL ever chased).

Manual single box:

chart.add_position_box(
    open_time=1700000000, close_time=1700003600,
    entry_price=50_000, stop_loss=49_500, take_profit=51_000,
    direction="long", net_pnl=100.0, close_reason="tp",
    trade_id=1, rr_ratio=2.0,
)

Indicator Toolbar (v0.8.0)

The chart toolbar has an INDICATORS button on the left. Clicking it opens a panel where indicators can be added — and edited — interactively at runtime, no code required:

  • Moving averages: EMA, SMA, WMA, SMMA, DEMA, TEMA, HMA, VWMA, VWAP
  • Oscillators: RSI (with optional MA), MACD, ATR
  • Trend: Ichimoku Cloud (Tenkan / Kijun / Senkou B / Displacement)

Each type shows its own parameter form. After clicking Add to Chart, the backend computes the indicator from the OHLCV data and the chart updates immediately (no maths in the browser). Every indicator on the chart gets a ⚙ gear icon in the legend — click it to re-open the panel pre-filled with the current settings; saving recomputes it server-side.

Indicators on the Simulation Chart (v0.8.0)

When show_chart=True, pass chart_indicators to draw indicators on the simulation chart automatically. Use the same parameters your strategy trades on to mirror it exactly, add extra indicators, or both — all computed in the backend before the chart opens (and still editable live via the toolbar):

config = SimulateConfig(
    show_chart=True,
    chart_indicators=[
        {"kind": "ichimoku", "tenkan": 8, "kijun": 22,
         "senkou_b": 44, "displacement": 22},   # match the strategy
        {"kind": "rsi", "period": 14, "source": "close"},
        {"kind": "ema", "period": 200, "source": "close"},  # extra
    ],
)

Strategy Drawings (v0.7.0)

from AlgoTradeKit.visual.indicator_renderer import add_strategy_drawings
add_strategy_drawings(chart, strategy_result)

Navigate to Candle (v0.7.0)

chart.navigate_to_candle(timestamp_ms=1700000000000)

Live Updates (v1.0.0)

chart = Chart(host="0.0.0.0", candle_count_limit=2000)   # host default: 127.0.0.1
print(chart.url)                                          # print instead of opening a tab

pid = chart.add_live_position(open_time=…, entry_price=…, stop_loss=…,
                              direction="long", next_tp=…)
chart.update_live_position(pid, stop_loss=new_sl)         # trailing / risk-free move
chart.set_candle_limit(2000)                              # rolling window, browser mirrors it

An open trade draws as a dashed entry line plus a live SL line, colour-coded by zone (red = loss, amber = break-even, cyan = profit) and a dashed next-TP line. Every change is pushed to the open page, and refreshing the browser mid-session replays the current chart, not the state it started in.

⚠️ host="0.0.0.0" exposes the chart to anyone who can reach the port. An SSH tunnel is the safer way to view a VPS chart.


report — Simulation Report (v0.7.0)

An interactive single-page web report for a SimulateReport.

Timeframe Switching (v1.1.0)

Give the chart its finest candles and display any whole multiple of them. The resampling — and the indicator maths on top of it — happens in Python; the browser only asks for a timeframe.

chart = Chart.from_csv("data/btc_1m.csv", display_timeframe="5m")
chart.add_indicator_spec({"kind": "ema", "period": 50})
chart.show(block=True)          # a 1m / 3m / 5m / 15m … selector sits in the toolbar

chart.set_timeframe("15m")      # or from Python; same code path as a click
chart.set_timeframe(None)       # back to the source candles
chart.source_timeframe          # detected from the data, or set it explicitly
chart.timeframes                # what the selector offers

Only whole multiples are offered: 4h data can become 12h or 1d, never 6h. Restrict the list with timeframes=["5m", "15m", "1h"].

Indicators are handled by where they came from:

Added by On a timeframe change
add_indicator_spec / chart_indicators / the toolbar recomputed on the new candles — exact
add_indicator_from_atk, add_rsi, add_macd, add_ichimoku thinned last-value-per-bucket and flagged approximate

Drawings and position boxes are absolute-time, so they stay put.

A partly-covered first candle is dropped — 1m data starting at 09:55 would otherwise show a 09:45 fifteen-minute candle claiming an open it never had. The partly-covered last candle is kept, because that one is still forming.

Several Charts on One Page (v1.1.0)

from AlgoTradeKit.visual import Chart, ChartPage

page = ChartPage(title="BTC desk")
page.add(fast)             # row 0
page.add(slow)             # row 1 — a new row, stacked underneath
page.add(eth, row=1)       # beside slow — side by side
page.show(block=True)

Rows stack top to bottom and the charts inside a row sit left to right, with dividers you can drag on both axes.

Charts scroll and crosshair together by time, so a 3m and a 1h chart stay on the same instant instead of the same candle number. Both syncs toggle from the page header, or at construction with sync_time= / sync_crosshair=.

Everything — the page, every chart and every WebSocket — is served from one port, so viewing a VPS page still needs only one SSH tunnel.

Attaching a chart changes nothing about how you drive it: indicators, drawings, live positions, streaming and set_timeframe all work exactly as they do on a chart of its own. Charts can also be added after show().

Bar Replay (v1.1.0)

Press ⏵⏵ REPLAY, click a candle, and the chart forgets everything after it.

  • ▶| / ◀ step, ▶ plays at 0.25×–10×, ⏮ returns to the start, ✕ leaves.
  • Keyboard: Space, Shift+→, Shift+←, Esc.
  • A step is one source candle, so a chart showing 5m built from 1m data advances a minute at a time and you watch the 5m candle being built.
  • Indicators stop at the last closed candle. Series that legitimately run ahead of the data — Ichimoku's projected spans — keep that overhang.
  • Backtest positions do not give the future away: a trade that has not opened is not drawn, and one still open at the cursor stops there with no result label.

On a ChartPage the replay bar lives in the page header and drives every chart from one cursor, stepping by the finest source timeframe on the page.

Show in Browser

from AlgoTradeKit.report import show_report
show_report(report, block=True)

Save as Standalone HTML

from AlgoTradeKit.report import save_report_html
save_report_html(report, "report.html")

Report Page Sections

Section Contents
Header Symbol, config ID, PnL badge, PDF export
Config All SimulateConfig parameters
Equity curve Wallet/equity line, max DD shading, DD regions, trade dots (zoom/pan)
Trade tooltip Entry/exit, SL/TP, PnL, R-multiple, close reason + "Open Chart" button
Performance KPIs PnL%, win rate, avg win/loss, largest win/loss, avg R
Risk metrics Profit factor, expectancy, Sharpe, Sortino, Calmar, recovery factor
Trade stats Total/long/short, win/loss/BE, SL/TP/RF/FC/EOD counts
Drawdown table All DDs above threshold, sorted by severity
Weekday analysis Trades, win%, PnL per weekday
Session analysis London, New York, Tokyo, Sydney, Off-Hours
Monthly analysis Per-month: trades, win%, total PnL, avg PnL
Cost summary Commission, spread, avg MAE, avg MFE

Clicking a trade dot on the balance chart pins its details open (v1.1.0 — before that the box followed the pointer and closed before you could reach it). It stays until you click elsewhere or press Esc, so "Open on Candle Chart" is clickable: it opens the linked chart at that trade's entry candle.

Live Updates & Portfolio Reports (v1.0.0)

from AlgoTradeKit.report import ReportServer, show_combined_report

server = ReportServer(host="127.0.0.1")
server.push_update(fresh_report)     # re-renders the open page in place

A combined report aggregates several pairs into one page — merged trade list, equity curve summed across accounts, and a per-pair breakdown table:

show_combined_report({"BTCUSDT": btc_report, "EURUSD": eur_report})

A report built from real broker fills is an ordinary SimulateReport, so every path above renders live trading exactly like a backtest.


Built-in MACD Strategy Demo

"""demo_macd.py — run MACD strategy, open chart + report."""

import pandas as pd
from AlgoTradeKit.strategy.builtin.macd import MACDCrossoverStrategy
from AlgoTradeKit.simulate import Simulate, SimulateConfig

# Load data (replace path with your CSV)
data = {"1h": pd.read_csv("data/binance-futures_BTCUSDT_1h.csv")}

# Run strategy
strategy = MACDCrossoverStrategy(fast=12, slow=26, signal=9,
                                  sl_atr_multiplier=1.5, timeframe="1h")
result = strategy.run(data)
print(f"Signals: {result.signal_count}")

# Simulate with auto chart + report
config = SimulateConfig(
    symbol="btcusdt",
    leverage=10,
    commission=0.001,
    risk_per_trade=1.0,
    tp_mode="fixed_rr",
    tp_rr=2.0,
    show_chart=True,
    report_mode="webpage",
)
report = Simulate(config).run(result)
print(report)

# Keep servers alive
import time
try:
    while True: time.sleep(1)
except KeyboardInterrupt:
    pass

Run:

python demo_macd.py

Two browser tabs open:

  • Candle chart — with MACD indicator and position boxes for every trade
  • Report page — equity curve, full metrics, drawdown table, time analysis

Configuration Reference

Report Mode Constants

Constant Value Behaviour
REPORT_MODE_NONE "none" No report (default)
REPORT_MODE_WEBPAGE "webpage" Open in browser
REPORT_MODE_SAVE "save" Save standalone HTML
REPORT_MODE_BOTH "both" Open + save

TP Mode Constants

Constant Value Behaviour
TP_MODE_SIGNAL "signal" Use Signal's take_profit
TP_MODE_FIXED_RR "fixed_rr" entry ± tp_rr × SL distance
TP_MODE_MULTI_RR "multi_rr" Multiple levels, SL trails (and optionally partially closes — see tp_level_close_fractions (v0.7.3))
TP_MODE_NONE "none" No TP

Close Reason Constants

Constant Value Meaning
CLOSE_REASON_SL "sl" Stop loss hit
CLOSE_REASON_TP "tp" Take profit hit — nothing left open afterwards
CLOSE_REASON_TP_PARTIAL "tp_rr" v0.7.3 Intermediate multi_rr level partially realised — position still open with reduced size
CLOSE_REASON_RF "rf" Risk-free / trailed SL hit
CLOSE_REASON_FC "force_close" Closed by an ExitSignal
CLOSE_REASON_EOD "end_of_data" Still open when data ran out

SL Mode Constants

Constant Value Behaviour
SL_MODE_SIGNAL "signal" Use Signal's stop_loss
SL_MODE_TRAILING "trailing" Trail trailing_sl_percent% from peak

Trader Constants (v1.0.0)

from AlgoTradeKit.trader import …

Constant Value Behaviour
EXEC_CANDLE_CLOSE "candle_close" Evaluate once per closed candle, at the exact venue-clock boundary (default)
EXEC_CANDLE_UPDATE "candle_update" Re-evaluate on every forming-candle update
EXEC_TICK "tick" Re-evaluate on every tick
DISPLAY_TRADES_SIM "sim" Display shows theoretical simulated trades (default)
DISPLAY_TRADES_REAL "real" Display shows actual broker fills
DISPLAY_TRADES_BOTH "both" Real fills overlaid on simulated trades
ON_STOP_KEEP "keep" On shutdown, leave positions open under their venue SL/TP (default)
ON_STOP_CLOSE_ALL "close_all" On shutdown, market-close everything and cancel working orders

Event types — the domain of log_event_types, and ALL_EVENT_TYPES is the full set: EVENT_SIGNAL, EVENT_EXIT_SIGNAL, EVENT_OPEN, EVENT_SL_MOVE, EVENT_RISK_FREE, EVENT_TP_LEVEL, EVENT_CLOSE, EVENT_DAILY_LOSS, EVENT_RECONCILE, EVENT_ERROR.


License

MIT — see LICENSE.

Metadata

Release files for AlgoTradeKit 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for AlgoTradeKit 1.2.0
File Size Uploaded Provenance
algotradekit-1.2.0.tar.gz 771.2 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for AlgoTradeKit 1.2.0
File Interpreter ABI Platform
algotradekit-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.3 MB

Release files / algotradekit-1.2.0.tar.gz

Download URL algotradekit-1.2.0.tar.gz
Size 771.2 kB
Tags Source
SHA-256 checksum
How to use checksums
1ca08b4164f11f26009bc2f700e3aa2a82ec15ef0a7dad71f89789f13ef6d44c
BLAKE2b-256 checksum
How to use checksums
9f34453e6c295d0f56cdc2dca0c7f69cb9bd201450f4d9d91b8ad70906a68f9b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / algotradekit-1.2.0-py3-none-any.whl

Download URL algotradekit-1.2.0-py3-none-any.whl
Size 505.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a27aef305130e0ae4b061477b11dbc042e868b26dcdfb0ea7faa86b1c9ae8b6b
BLAKE2b-256 checksum
How to use checksums
d53d1cdb0e503ba61b4d9c8256603d4dd87d6f50128cad4ea50992006f8fedd1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Security for AlgoTradeKit 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for algotradekit-1.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page