All notable changes to this project are documented here.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Polymarket section — prediction markets alongside the Binance side:
- Restored
PolymarketVenue(CLOB market data + wallet-signed live orders viapy-clob-client) with per-venue encrypted credentials (private_key,api_key,api_secret,passphrase,wallet_address). - Per-strategy venue routing: strategies (and AI signals) carry a
venue, so Binance and Polymarket strategies run side by side; Testnet mode falls back to Sim for venues without a sandbox. Symbol columns widened to 80 chars for outcome-token ids (migrations 0022–0023). - Market discovery: scheduled Gamma-API refresh into a local catalogue with a watchlist; new Polymarket page to browse, search and pin markets.
- AI bet analysis: the report-writer LLM estimates each market's true probability from question-matched news headlines and market context; the edge (estimate − price) is stored per analysis and shown on the page.
- Suggestions & alerts: a scheduled screener analyses the watchlist + top-volume markets; analyses clearing the configurable edge/confidence bars become pending AI signals (Telegram + dashboard) that execute through the existing risk-gated confirmation path.
- Prediction AI strategy: a pickable, Polymarket-pinned strategy type that trades one outcome token on the stored analyses with notify/auto action modes, allocation, risk and loss-cap enforcement.
- Resolution settlement: watched/held markets are re-checked hourly; on resolution, held tokens settle at 1/0 USDC into the ledger and the operator is alerted.
- Restored
- Adopted the Dev-Template
scaffolding: two-trunk branching model (
mainstable /testintegration with auto-promote),.editorconfig,.gitattributes,AGENTS.md,SECURITY.md, expandeddocs/(Architecture, Branching, PR guidelines, Releases). Migrated commitlint config to.commitlintrc.yaml. - Sourced Claude skills (
conventional-commits,conventional-branches,modular-services) from the My-Skills plugin marketplace instead of vendoring them locally. - Reorganized
docs/by topic intodocs/operations/anddocs/venues/; normalized naming to lowercase-kebab; trimmedREADME.mdby moving manual setup and the project-structure tree to a newdocs/development.md; added a topicaldocs/README.mdindex. - Consolidated three open engine refactors (#139, #140, #141) into a single
modular-services pass: typed
PositionFillRequest, extractedmanual_orderservice, and extractedstrategy_viewprojection.
- Platform reduced to Binance only. Removed the
AlpacaVenue,PolymarketVenue, andBinanceAlphaVenueimplementations and their dedicated tests. TheVenueABC and registry/factory shape are preserved so re-adding a venue later is one new implementation file plus a registry entry. Multi-venue parametrize blocks in cross-cutting tests have been trimmed to Binance.
0.2.0 - 2026-05-22
- Read-only Binance Alpha tokenized-stocks venue (#118).
- AI-provider config and API-token management UI (#44).
AIStrategyand the analyze-and-decide endpoint (#41).- Backtest API and page (#27).
- History & Logs page with CSV export (#39).
- Portfolio API + Dashboard page (#19, #65).
- Role-scoped, revocable API tokens (#42).
- Strategies management API and page (#24).
- Trading-mode toggle, encrypted API keys, Settings page (#31).
- Venue catalogue API and Settings venue list (#105).
- engine: accounting layer + equity snapshots (#18, #64).
- engine:
AlpacaVenue— US stock trading (#103). - engine: auth, roles, JWT, audit log & user management (#3, #50).
- engine: backtest runner with cost model and metrics (#26).
- engine: Binance REST client wrapper (#9, #55).
- engine: Binance WebSocket market-data streams (#10, #57).
- engine:
BinanceVenuebehind the Venue interface (#102). - engine: candle cache (market-data models) (#11, #56).
- engine: custom strategy plugin loader (#21).
- engine: watchdog with heartbeat (#34).
- engine: historical kline downloader (#25).
- engine:
LLMProviderabstraction and adapters (#40). - engine: MA crossover strategy + wire the trading engine (#17, #63).
- engine: market-data REST + WS API (#12, #58).
- engine: MCP server exposing the platform as agent tools (#43).
- engine: order/position reconciliation with Binance (#30).
- engine:
PolymarketVenue— prediction markets (#104). - engine: portfolio model + position-attribution sub-ledger (#14, #60).
- engine: PostgreSQL service, DB layer & Alembic (#2, #49).
- engine: risk manager — sizing, SL/TP and kill switch (#23).
- engine: RSI, MACD, Bollinger and DCA strategies (#20).
- engine:
SimExecutor— paper fills (#15, #61). - engine: strategy framework + tick loop (#16, #62).
- engine: Testnet and Live order executors (#28).
- engine: Venue abstraction interface (#46).
- engine: drain the in-flight tick on graceful shutdown (#37).
- engine: per-strategy allocation and lifecycle rules (#22).
- engine: freeze trading on a stale market feed (#35).
- engine: orders placed through the Venue interface (#110).
- engine: reconcile open positions with Binance on boot (#33).
- engine: resolve the active venue from the persisted setting (#110).
- engine: route market-data klines API through the active venue (#110).
- engine: route orders through the mode's executor (#98).
- engine: scaffold uv project + FastAPI health endpoint (#1, #48).
- engine: source tick-loop candles through a Venue (#110).
- engine: structured logging, retention pruning, Telegram alerts (#38).
- engine: symbol-filter validation, clientOrderId, funding fetch (#29).
- infra: engine + web compose services and dev override (#6, #52).
- Active trading venue as a persisted setting (#110).
- Manual operator-placed orders (#119).
- Multi-model AI strategies with per-strategy model selection.
- Per-model AI performance rollup and decision log.
- Per-venue encrypted credential storage (#120).
- Schema-first API contract pipeline (#5, #54).
- Public cloud-VM deployment support.
- LLM usage tracking and daily spend cap.
- Trading-cost visibility on the dashboard.
- web: live Markets page + wire real engine auth (#13, #59).
- web: venue-aware Markets, Strategies and History pages (#110).
- web: dark UI shell, design system & routing (#4, #47).
- Alpaca & Polymarket venue routing wiring (#120).
- engine: build BinanceVenue's client lazily.
0.1.0 - 2026-04
Initial release. See git history for details.