Skip to content

Conventions

Firm-wide rules every app follows. When code and this page disagree, one of them is a bug.

Machines and data movement

Rule Detail
TRADER-1 Data, build and research machine. Runs the automation pipeline.
TRADER-2 Production. Runs TI, OC Dashboard and OC Charts until TI moves to a colocated server.
Nothing by hand on TRADER-2 Everything it needs arrives through the installer or through R2. No CME margin work or browser downloads happen there.
R2 dead drop Cross-machine data moves through Cloudflare R2: the producing box uploads (OC_Maintenance push-file --path --key, keys under reference/), the consuming box fetches. No SMB shares, no scheduled copies. TRADER-2 takes no inbound connections.
Common root C:\Outlier Capital\ exists on both machines. Anything both boxes need lives under it.

Folders

Folder Holds
D:\Software\Outlier Capital\<App> Source (TRADER-1)
D:\Software\Automation\<App> Deployed automation: the CLI project and the minimum files to run it. Release builds copy here automatically.
C:\Outlier Capital\Config Files Settings that change over time. One copy of each file.
C:\Outlier Capital\Reference Data Reference files (Contract Specs, calendars, commissions). One copy of Contract Specs.csv.
C:\Outlier Capital\Shared Libraries\C# Deployed shared-library DLLs. Every library's post-build step copies its .dll here.
C:\Outlier Capital\Log Files\<AppName> One log folder per app.
E:\Support Data\Historical Contract Dates\Contract Rolls\{ROOT}.csv Roll calendars on TRADER-1.

All code resolves paths through OutlierCapital.Paths. The only concrete paths outside it are launchers (Task Scheduler scripts), because Windows starts the process before any OC code runs.

Code

Rule Detail
Solution layout Three projects: .Core (logic), .WPF (window), .CLI (automation).
Shared code A standalone library in its own solution and repo, referenced as a deployed DLL — never a project embedded in one app's solution.
OutlierCapital. prefix Libraries only, never apps or exes.
Naming Spaces in human-facing paths; underscores in code identifiers and Automation deploy folders.
Target .NET 8, x64 everywhere.
Tunable values Thresholds and limits live in config files, never hard-coded.
WPF background #808080.
Numbers Parentheses mean negative, and nothing else.

Logging and exit codes

Every automation app logs through OutlierCapital.Logging: pipe-delimited lines in C:\Outlier Capital\Log Files\<AppName>\<AppName>_<date>.log.

Exit code Meaning What the chain does
0 Success Continues
1 Finished with warnings — HUMAN_REQUIRED Continues; Master Log Reader reports it
2 Fatal Stops
Channel Used for
Pushover TI only
Email Failures only (never success notices), plus the daily Morning Futures Brief

Market data

Rule Detail
Bar timestamps Bars are stamped at their close.
Bar file names Hour multiples are named in hours: 1 Hour Bars, 4 Hour Bars; others stay in minutes (90 Minute Bars).
Contract names Two-digit years (ESZ26). Databento uses one-digit years (ESZ6).
Serial contracts !1, !2, ... (CL!2 = second serial). Held positions name specific months, not serials.
Tick-data source order Databento MBP-1 if it exists, else Databento TBBO, else Kibot. Databento→Kibot tickers via the Contract Key Matrix.
Continuous contracts Ratio-adjusted for indicators (returns); additive-adjusted for P&L and execution (dollars). Databento data carries no roll adjustments — the firm owns rolls.
Trading calendar Scheduled hours only. Outages are kept separately in Exchange_Outages.csv, with exact times.
CME session schedule From the CME Trading Hours export, downloaded once a day by the CME Schedule Scraper.

Spreads

Rule Detail
Synthetic spread price Denominated in the primary leg and indexed to $100 per handle, e.g. Kilo = ((6C×4 − 6N×5)×100000 − MCL×100)/100.
Exchange-traded spreads Keep the exchange's own naming and pricing.
Flies and condors Priced on the guts: fly = 2 × body − wings; condor = inner pair − outer pair.
Pricing source Bid/ask midpoint. When the spread is wider than MaxWidth (Spreader Settings.csv) the price is ignored until it conforms — the same rule everywhere spreads are priced.
Hedge ratio Re-estimated only between trades, held constant for the life of a trade.
Calendar names 1-2, 2-3, ...

Margins and commissions

Item Source
Commissions Ironbeam Commissions Schedule.csv in Reference Data only — never Contract Specs.
Overnight / maintenance margin CME margin file.
Intraday margin Ironbeam. If Ironbeam quotes none, use the plain CME margin (no markup). NOK and SEK never have an Ironbeam rate — that's normal.
Intraday margin window Applies through the overnight session (17:00 CT on, same trade date); not in the last 15 minutes of the day, nor to a position held across the session boundary.

Secrets

Pages say where a secret lives, never its value: e.g. "Credentials.csv in Config Files". The build stops if a page contains anything that looks like a key.