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.