FTH Trading Engine documentation
A deterministic, event-driven trading engine in development at FTH Trading. Every page carries a status label. Start with the quickstart or pick a section.
RealSimulationTestnetBeing builtPlannedProposedReference
Getting started
QuickstartReferenceWhat the FTH Trading Engine is, what exists today, and how to read these docs.Build from sourceRealNo package is published. The engine builds from source with Rust's own tools.Roadmap and statusReferenceThe single place that says what is built.ChangelogReferenceEvery change, newest first.
Concepts
OverviewRealThe engine in one page.ArchitectureRealThe kernel, its components, and the order things happen in.Rust coreRealEverything that exists is written in Rust.Python layerProposedBindings for research and strategy code. A design only.InstrumentsRealHow a tradable thing is described today, and what is planned.Value typesRealPrice and Quantity: exact, fixed-precision integers.Market dataRealThe data the engine understands.EventsRealEverything that happens is an event.OrdersRealOrder types, time in force, brackets and the state machine.ExecutionRealFrom a strategy command to a venue and back.Risk checksRealEvery order is checked before it can reach a venue.Positions and portfolioRealPositions and profit and loss derived from fills only.Run statistics and tear sheetsRealWhat a backtest reports, and the single-file HTML tear sheet.StrategiesRealThe strategy API.Message busRealDeterministic, single-threaded publish and subscribe.CacheRealIn-memory instruments and market data.Clock and timersRealNanosecond time, a test clock and a live clock.LoggingPlannedStructured logs off the hot path.BacktestingSimulationStrategies run over history against the simulated venue.The live engine seamRealOne engine, generic over a venue, run step by step.Reconciliation after restartRealA restarted session imports what is already open at the venue.Deterministic replayRealThe same input gives the same run, and CI checks it.Venue adaptersReferenceWhat a venue adapter does, and which exist.
Venues
Simulated venueSimulationThe top-of-book matching model used in backtests.XRPL venueTestnetThe engine's Venue trait over the XRP Ledger's built-in order book, on the test network only.Coinbase Exchange sandbox venueTestnetThe engine's Venue trait over the Coinbase Exchange sandbox REST API, with test funds only.Polymarket market data (read-only)RealPublic Polymarket order books turned into engine quotes. Read-only: no orders, no signing, no wallet.
Tools
fth-xrpl CLITestnetThe XRPL testnet utility. Every command that talks to a server first checks that the network id is 1.Token tools on testnetTestnetIssuer setup, issue, freeze, clawback and AMM create on the XRPL test network. Built and independently reviewed; not yet run on any network.fth-catalog and loading dataRealImport CSV files into the Parquet catalog and verify it.First backtestSimulationRun the two example backtests.
Quality
TestingRealHow the suite was built, and its size at each step.Review and verificationReferenceHow the independent reviews worked, what they found, and what was fixed.Security approachReferenceWhat is in place, stated plainly. No audit has been done and none is claimed.