Configuration Files

OptionsRealTime uses JSON configuration files to define default settings for both the desktop application and Rover. These files are read at startup and serve as the “factory defaults” that back every Settings dialog’s Reset to Defaults button.

Power users can customize these files to establish their preferred baseline configuration across installations or machines.

File Locations

File	Purpose	Location
`OptionsRealTimeConfig.json`	Desktop application defaults	Application directory
`RoverConfig.json`	Publisher launcher defaults	Application directory

RoverConfig.json

Controls Rover’s TWS connections, publisher behavior, and global pricing parameters.

{
    "AccountIdMaskChars": 4,
    "IBKRConnections": [
        {
            "AccountId": "U1234567",
            "ClientId": 1,
            "GatewayIPAddress": "localhost",
            "GatewayPort": 7496
        }
    ],
    "MsgProcessingInterval": 100,
    "NATServerURL": "nats://localhost:4222",
    "RiskFreeRate": 0.036,
    "ThroughputBaselineBytes": 50000
}

Connection Settings

Field	Type	Description
`NATServerURL`	string	NATS server address and port. Default: `nats://localhost:4222`
`MsgProcessingInterval`	integer	Milliseconds between message processing cycles. Default: `100`

IBKRConnections Array

Each entry defines a connection to a TWS instance:

Field	Type	Description
`AccountId`	string	IBKR account identifier (e.g., `U1234567` for live, `DU1234567` for paper)
`GatewayIPAddress`	string	Host running TWS. Use `localhost` for local installations
`GatewayPort`	integer	TWS API port. Typically `7496` for live, `7497` for paper
`ClientId`	integer	Unique client ID for this connection. Multiple accounts on the same TWS instance require different client IDs

Display Settings

Field	Type	Description
`AccountIdMaskChars`	integer	Number of characters to mask from the right in account IDs (0-8). `4` shows `U264****`
`ThroughputBaselineBytes`	integer	Sets the 100% reference for throughput bar charts (bytes/second)

Pricing Parameters

Field	Type	Description
`RiskFreeRate`	float	Annualized interest rate for options pricing (e.g., `0.036` = 3.6%). Applied uniformly across all accounts and expirations using QuantLib’s flat rate model

OptionsRealTimeConfig.json

Controls the desktop application’s appearance, chart settings, and UI behavior. These values appear in the various Settings dialogs throughout the application.

{
  "natsServerURL": "nats://localhost:4222",
  "msgProcessingTimeMSec": 100,
  "configurationDir": "Configuration",
  "app": { ... },
  "titlebar": { ... },
  "dashboardMetric": { ... },
  "dataColors": { ... },
  "quotes": { ... },
  "maturityChart": { ... },
  "exposureChart": { ... },
  "volScenarioChart": { ... },
  "tables": { ... },
  "pnlGraph": { ... },
  "reportGrid": { ... },
  "graphContainer": { ... },
  "metricsContainer": { ... },
  "logViewer": { ... }
}

Global Settings

Field	Type	Description
`natsServerURL`	string	NATS server address. Default: `nats://localhost:4222`
`msgProcessingTimeMSec`	integer	Message processing interval in milliseconds. Default: `100`
`configurationDir`	string	Directory for user configuration files. Default: `Configuration`

app (Application Settings)

Controls global application appearance accessible via the Application Settings dialog.

Field	Type	Description
`baseFontSize`	integer	Base font size in points for the application. Range: 8-24
`themeColor`	string	Hex color for the application theme (e.g., `#1e1e1e`)
`dataColorOpacityPct`	integer	Opacity percentage for data colors (0-100)
`chromeAlphaPct`	integer	Chrome/UI element intensity (0-200)
`accountIdMaskChars`	integer	Characters to mask in account IDs (0-10)
`focusScrollingEnabled`	boolean	When `true`, scroll content under mouse without Shift key

titlebar (Titlebar Font)

Field	Type	Description
`fontSize`	integer	Titlebar font size in points
`fontFamily`	string	Font family name (e.g., `Segoe UI`, `Consolas`)
`fontItalic`	boolean	Whether titlebar text is italicized

dashboardMetric (Dashboard Metrics)

Controls the appearance of metric tiles on the Dashboard.

Field	Type	Description
`fontSize`	integer	Metric value font size in points
`fontFamily`	string	Font family for metric values
`fontItalic`	boolean	Whether metric values are italicized

dataColors (Data Value Colors)

Defines colors for positive, negative, and neutral values throughout the application.

Field	Type	Description
`positive`	string	Hex color for positive/up values (e.g., `#003600`)
`negative`	string	Hex color for negative/down values (e.g., `#830504`)
`neutral`	string	Hex color for flat/unchanged values (e.g., `#000000`)

quotes (Quote Container)

Field	Type	Description
`fontSize`	integer	Font size for quote displays
`borderThickness`	integer	Border thickness around quote tiles

maturityChart (Maturity Chart)

Field	Type	Description
`fontSize`	integer	Axis and label font size
`markerSize`	integer	Size of data point markers
`legendVisible`	boolean	Show/hide the chart legend
`currentValuesVisible`	boolean	Show/hide current value labels on data points
`itmColor`	string	Hex color for in-the-money markers
`otmColor`	string	Hex color for out-of-the-money markers

exposureChart (Exposure Chart)

Field	Type	Description
`fontSize`	integer	Axis and label font size
`ascending`	boolean	Sort order for bars (`true` = ascending)
`showAnnotations`	boolean	Show/hide value annotations on bars

volScenarioChart (Volatility Scenario Chart)

Field	Type	Description
`fontSize`	integer	Axis and label font size
`drawingStyle`	string	Line style: `LINE` or `SPLINE`
`legendVisible`	boolean	Show/hide the chart legend
`colorMktIV`	string	Hex color for market IV curve
`color10IV`	string	Hex color for 10% IV scenario curve
`color25IV`	string	Hex color for 25% IV scenario curve
`color50IV`	string	Hex color for 50% IV scenario curve
`color75IV`	string	Hex color for 75% IV scenario curve

tables (Table Settings)

Field	Type	Description
`zoomFactor`	integer	Zoom percentage for all tables (25-300). Default: `100`

pnlGraph (PnL Graph)

Field	Type	Description
`axesFontSize`	integer	Font size for axis labels
`titleFontSize`	integer	Font size for graph title
`showReferenceLine`	boolean	Show/hide the zero reference line
`showReferenceLabel`	boolean	Show/hide the reference line label
`lastWindowEnabled`	boolean	Limit display to a time window
`lastWindowSeconds`	integer	Time window duration in seconds
`gapEnabled`	boolean	Enable gap detection in time series
`gapSeconds`	integer	Minimum gap threshold in seconds
`portfolioLineColor`	string	Hex color for portfolio PnL line
`netLiqLineColor`	string	Hex color for net liquidation line

reportGrid (Report Grid)

Field	Type	Description
`zoomPercent`	integer	Zoom percentage for report grids
`rowHeightDelta`	integer	Adjustment to default row height
`summaryBrightness`	integer	Brightness factor for summary rows (0-100)
`detailBrightness`	integer	Brightness factor for detail rows (0-100)
`showGrid`	boolean	Show/hide grid lines
`gridThickness`	integer	Grid line thickness in pixels
`gridColor`	string	Hex color for grid lines
`enableStriping`	boolean	Enable alternating row colors
`stripeContrast`	integer	Contrast level for row striping
`cellPaddingH`	integer	Horizontal cell padding in pixels
`cellPaddingV`	integer	Vertical cell padding in pixels
`hoverOverlayAlpha`	integer	Opacity of hover highlight (0-255)
`selectionOverlayAlpha`	integer	Opacity of selection highlight (0-255)

graphContainer (Graph Container)

Controls the PnL Charts container which holds multiple graphs.

Field	Type	Description
`axesFontSize`	integer	Font size for axis labels
`titleFontSize`	integer	Font size for graph titles
`width`	integer	Default graph width in pixels
`height`	integer	Default graph height in pixels
`borderThickness`	integer	Border thickness around graphs
`quoteChipSize`	integer	Size of quote indicator chips
`quoteChipOpacity`	integer	Opacity of quote chips (0-100)
`lastWindowEnabled`	boolean	Limit display to a time window
`lastWindowSeconds`	integer	Time window duration in seconds
`gapEnabled`	boolean	Enable gap detection
`gapSeconds`	integer	Gap threshold in seconds
`showLeftReferenceLine`	boolean	Show reference line on left axis
`showLeftReferenceLabel`	boolean	Show label on left reference line
`showRightReferenceLine`	boolean	Show reference line on right axis
`showRightReferenceLabel`	boolean	Show label on right reference line
`series0Visible`	boolean	Visibility of first data series
`series1Visible`	boolean	Visibility of second data series

metricsContainer (Metrics Container)

Field	Type	Description
`fontSize`	integer	Font size for metric values
`borderThickness`	integer	Border thickness around metric tiles

logViewer (Log Viewer)

Field	Type	Description
`fontSize`	integer	Font size for log text

Editing Configuration Files

Close OptionsRealTime and Rover before editing
Open the JSON file in a text editor
Make changes, ensuring valid JSON syntax
Save the file
Restart the application

Changes take effect on the next application start. Invalid JSON will cause the application to fall back to hardcoded defaults.

Resetting to Defaults

Each Settings dialog includes a Reset to Defaults button that restores values from these configuration files.