Documentation

Everything you need — in one terminal.

A complete reference for the ./sentral terminal. Every window, every shortcut, every supporting tool — covering the command palette, chart types, position monitoring, signal scanning, the heatmap, community chat, risk calculators, dashboards, exports and account management.

Contents

01

Getting started

When you open the terminal, a brief loading animation plays whilst the initial data loads. Once it completes, the top bar appears and you land in an empty workspace ready for you to arrange.

Press Tab to open the command palette. Type a ticker such as ES or GC and press Enter to open the default combined chart, or type any shortcut code (PM, SGL, HMP…) to open a utility window.

Open as many windows as you like. Drag, resize and arrange them freely. Your layout persists across sessions, and you can save named dashboards for specific workflows — see Saved dashboards.

02

Command palette

The command palette is the primary way to open windows and find contracts. Open it with Tab or click the search bar in the top bar.

Searching for contracts

Start typing a ticker (e.g. EUR, CL, GC) or a contract name (e.g. “gold”, “crude”). Search is fuzzy — it tolerates typos and partial matches — and results are ranked by relevance with ticker matches weighted highest.

Use to navigate results and Enter to open the default combined chart. To pick a different chart type, press Tab whilst a contract is highlighted and choose from POS, IDX, CMB, COT, RISK, MOV or TERM.

Command codes

Every window is reachable by typing a short code into the palette:

CodeWindowDescription
CMBCOT Combined ViewPositioning bars and COT index lines on a shared axis
IDXCOT IndexNormalised 0–100 index for each trader category
POSCOT PositioningNet positions by trader category
MOVCOT Movement IndexWeek-over-week change in COT index values
COTCOT ReportFull CFTC report tables, all seven report types
SGLCOT SignalCross-market signal scanner
HMPCOT HeatmapGrid of COT index values across every contract
AGGCOT AggregateCombine multiple contracts into a single chart
PMPosition MonitorWatchlist table with chart shortcuts and saved universes
RISKRisk CalculatorPosition sizing and stop-loss calculator
TERMTerm StructureFutures price curve across delivery months
SCHCFTC Release ScheduleCalendar of COT report release dates
CHATCommunity ChatPublic rooms, direct messages and group chats
DOCSDocumentationThis reference, in a floating window

Palette controls

KeyAction
TabOpen the palette, or enter chart-type selection whilst a contract is highlighted
EnterSelect the highlighted item
Navigate results
EscapeClose the palette or go back to search
03

Managing windows

The terminal uses a floating-window interface. You can open, move, resize and close any number of windows.

Drag & resize

Click and hold the title bar to drag a window. Hover any edge or corner to resize. Each window type has a minimum size to keep its contents legible.

Maximise & restore

Double-click the title bar to maximise a window to fill the workspace. Double-click again to restore its previous size and position. The maximise icon in the title bar does the same thing.

Focus & layering

Click any window to bring it to the front. Newly opened windows always appear on top of existing ones.

Closing windows

Click the × icon in any window’s title bar.

04

Top bar

The top bar spans the top of the workspace. From left to right, it contains:

Search bar

Click the search bar or press Tab to open the command palette.

PM and SGL shortcuts

Two quick-access buttons in the centre. Click PM to open a new Position Monitor or SGL to open a new Signal Scanner. Both support multiple open instances.

Window tabs

Each open chart window appears as a tab showing its ticker. Click a tab to focus that window; the active tab is highlighted in green. Tabs include a small close button.

Magnet / snap toggle

The magnet icon toggles window snapping on and off. See Magnet & snap for details.

Save & load menu

A save icon beside the magnet opens the Saved dashboards menu — capture the current layout as a named dashboard or load an earlier one.

User menu

The user icon on the far right opens the user settings menu — your profile, subscription, preferences, shortcuts reference, delete-account option and sign-out.

05

Chart types (POS, IDX, CMB)

Every chart in the terminal visualises Commitments of Traders data for a single futures contract. There are three core chart types, all interchangeable via the palette:

POS — Positioning

Net positions (long minus short) for each trader category: Commercials, Large Speculators and Small Speculators. Displayed as bars by default. Tells you how much each group is net long or net short in raw contract terms.

IDX — COT Index

A normalised 0–100 index for each trader category, computed over a configurable rolling lookback. Values near 0 mean positioning sits at its lowest historical level; values near 100 mean the highest. Includes variance bands. Displayed as lines by default.

CMB — Combined

A dual-panel chart showing both Positioning and Index on a shared time axis. This is the default chart type and gives the most complete picture at a glance. The vertical split between the two panels is adjustable.

Trader categories

CategoryColourDescription
CommercialsRedHedgers — producers and consumers of the underlying
Large SpeculatorsBlueInstitutional traders — funds and managed money
Small SpeculatorsYellowSmaller and retail traders
Open InterestGreenTotal outstanding contracts, shown as an optional reference line
06

COT Movement Index (MOV)

The Movement Index tracks how fast COT Index values are changing. It computes the difference between the current index and the index N weeks ago, then plots that rate of change over time — useful for spotting acceleration or deceleration in positioning swings. Open one by typing MOV in the palette, or choose it from the chart-type menu after selecting a contract.

Configuration

SettingDescription
MOV lookbackNumber of weeks between the two index values compared (default 6)
BandsThreshold bands around zero, marking notable movement levels (default ±40)
StyleHistogram or line
SmoothingOptional moving-average smoothing on the line style
Base lookbackThe underlying COT Index lookback period, inherited from chart settings
07

COT Report (COT)

The COT Report window displays full CFTC Commitments of Traders report tables, virtualised for speed across many weeks of history. Type COT in the palette to open one — multiple instances are supported.

Report types

All seven CFTC report variants are available from the report-type selector:

CodeReport
LFOLegacy Futures Only
LCOLegacy Combined (futures + options)
DFODisaggregated Futures Only
DCODisaggregated Combined
TFOTraders in Financial Futures (Futures Only)
TCOTraders in Financial Futures (Combined)
CITSupplemental Commodity Index Trader

Report sections

Toggle each section independently using the header buttons. Each one is colour-coded and renders in its own set of columns:

SectionContents
POSPositions — long, short, spreading and net, by trader category
CHGChanges — week-over-week change in each position field
%OIPercent of total open interest held by each category
TRDNumber of reportable traders in each category
CONConcentration ratios — top four and top eight trader holdings

Crop years

For agricultural contracts, toggle the CROP button to expose Old-Crop and Other-Crop breakdowns alongside the All-positions columns. Crop-year rows are available in Disaggregated and TFF report types.

Spawning charts from the report

Numeric cells in the report can be clicked to spawn a custom chart of that specific field over time — handy for drilling from a row in the table into a visual history of that single data series.

08

COT Signal (SGL)

The signal scanner sweeps every tracked contract for trading signals based on how extreme trader positioning is relative to a recent history window. Type SGL in the palette or click the SGL shortcut in the top bar. Multiple instances are supported.

Configuration

SettingDescription
GeneratorThe trader category whose index threshold triggers the signal
ContributorsAdditional trader categories that must also confirm the signal
Low thresholdMinimum COT index fill (0–100%) for a long signal
High thresholdMaximum COT index fill (0–100%) for a short signal
Base lookbackWeeks of history used to calculate the COT index (default 52)
Column lookbacksAdditional timeframes shown as columns (e.g. 13w, 26w, 52w, 104w, 156w)
Report typeLFO, LCO, DFO or DCO — which CFTC report feeds the scan
UniverseOptional — restrict the scan to a saved Position Monitor universe

Reading the grid

After clicking Generate, the result splits into two tables:

  • Long signals — contracts where the generator is at a bullish extreme
  • Short signals — contracts where the generator is at a bearish extreme

Each row is coloured across its lookback columns. A filled cell means the positioning meets the signal criteria at that timeframe. The thick bar represents the overall signal; thinner bars show the generator and each contributor individually.

Exporting

The SGL window supports screenshot and PDF exports of the result tables via the icons in its title bar.

09

Heatmap (HMP)

The heatmap gives a bird’s-eye view of COT index values across every tracked contract in a single coloured grid. Type HMP in the palette to open one — multiple instances can run side by side with different settings.

Reading the grid

Each row is a futures contract. Columns show the current COT index for Commercials, Large Speculators and Small Speculators. Cells run from deep red (index near 0 — positioning at historical lows) through a neutral dark middle (50) to deep green (index near 100 — positioning at historical highs).

Controls

ControlDescription
Report typeToggle between LFO (futures only) and LCO (combined)
LookbackIndex calculation window in weeks (1–200)
Asset-class filterLimit rows to a single class (Currencies, Metals, Grains, Rates, …)
UniverseRestrict rows to contracts in a saved Position Monitor universe; pick “All contracts” to remove the filter
Column sortClick a column header to sort by that category’s index, ascending or descending
Hover tooltipHover any cell to see the exact index value, net positioning and week-over-week change

Threshold colouring

Open the window’s settings wheel to enable threshold mode. When on, only values below the low threshold or above the high threshold receive colour; the neutral middle band is shown in grey. Low and high colours are both customisable via hex pickers.

Universes are created and managed in Position Monitor — see Position Monitor. Selecting a universe in the heatmap is instant and filters the existing result client-side; it does not re-query the server.
10

Position Monitor (PM)

Position Monitor is a table-based watchlist for tracking multiple contracts and launching any chart type in a single click. Open one by typing PM in the palette or clicking the PM button in the top bar. Multiple PM instances are supported.

Adding contracts

Click any empty ticker cell and start typing to fuzzy-search. Pick from the dropdown to fill the row. The List button at the bottom opens a bulk-add modal that groups every available contract by category with per-category and per-contract checkboxes.

Table columns

ColumnDescription
TickerContract symbol — click to re-search
NameFull contract name
Col 1Shortcut button — defaults to POS
Col 2Shortcut button — defaults to IDX
Col 3Shortcut button — defaults to CMB
RemoveDelete the row

Customising shortcut columns

Right-click any shortcut button to change the chart type it opens. You can mix POS, IDX, CMB and MOV freely across the three columns, and each PM instance stores its own configuration.

Batch operations

The All button at the head of each shortcut column opens that chart type for every row at once, as a single batch chart window.

Universes — saved contract sets

A universe is a saved set of PM rows you can swap in and out of a PM window. Universes persist server-side and are available to every PM instance in your account. They can also be used to scope the Signal Scanner and the Heatmap (see their respective sections).

ActionHow
CreateOpen the universe menu, type a name and press Enter
OpenClick a name in the universe menu to load it into the current PM instance
Switch activeUse the tabs at the top of the PM window to flip between opened universes
RenameDouble-click a name in the universe menu to edit it inline
DeleteDelete action in the universe menu — removes the universe from the server
Close in windowClose the tab — the universe is unchanged, just not loaded in this instance
11

COT Aggregate (AGG)

The Aggregate window lets you define named groups of contracts and generate aggregate charts that combine their positioning into a single view. Type AGG in the palette to open one.

Creating groups

Click New Group to create an empty group, then click its name to rename it. Groups are collapsible via the arrow on the left.

Adding contracts

Inside each group, the “+ Add contract…” input gives you two paths:

  • Type to fuzzy-search a specific contract and add it individually.
  • Leave the input empty and click a category name to bulk-add every contract in that asset class.

When every contract in a group belongs to the same asset class, the group is auto-renamed to that class (e.g. “Currencies”).

Generating charts

ButtonAction
POSOpen an aggregate Positioning chart for the group
CMBOpen an aggregate Combined chart for the group
AllBatch-generate the selected chart type for every non-empty group at once
12

Risk Calculator (RISK)

The Risk Calculator sizes futures positions against your account capital and a target risk percentage. Type RISK in the palette, or pick it from the chart-type menu after selecting a contract. Multiple instances are supported.

Modes

  • Calculate stop level — given a number of contracts, compute the stop price that keeps dollar risk within your target.
  • Calculate position size — given a stop price, compute the number of contracts you can trade.

Inputs

FieldDescription
ContractType a ticker or CFTC code — multiplier, tick size and contract unit are auto-filled from the spec database
Total capitalAccount size in dollars
Risk %Percentage of capital you are prepared to risk on this trade
Entry priceYour planned entry
# contracts / stopOne or the other, depending on mode
Contract multiplierAuto-filled from specs; can be overridden manually
Tick size (MPF)Minimum price fluctuation — used to round the resulting stop to a valid price
DirectionLong or short

Output

The calculator shows your dollar risk, the price distance to the stop and the exact tick-aligned stop price. Contract specs are cached for the session, so subsequent lookups are instant.

13

Term Structure (TERM)

The Term Structure window plots the futures price curve across delivery months for a single contract family. Type TERM in the palette, or pick it from the chart-type menu. Each point on the curve is a separate delivery month, labelled with its month-code (e.g. CLN26, CLZ26, CLF27).

Term structure is a live-market reading of supply and demand. An upward-sloping curve (further-dated contracts at a premium) is contango; a downward-sloping curve (nearer contracts more expensive) is backwardation. Use it alongside COT data to cross-check where speculative positioning is leaning versus where the physical market is actually pricing forward delivery.

14

CFTC Release Schedule (SCH)

SCH is a calendar of CFTC Commitments of Traders release dates. Type SCH in the palette to open it. The window lists the data date (Tuesday of the reporting week) alongside the official release date, with holiday adjustments applied. Future dates that are estimated rather than officially scheduled are marked as such.

Use the refresh button in the title bar to re-fetch the latest schedule from the server; a timestamp indicates when the current data was loaded.

15

Community Chat (CHAT)

The chat window brings real-time messaging into the terminal. Type CHAT in the palette to open it. It is a singleton — one window instance for all conversations.

Public rooms

Three public rooms are always available:

RoomPurpose
GeneralOpen discussion amongst ./sentral users
BugsReporting issues and tracking fixes
FeaturesIdeas, feedback and feature requests

Direct messages

To start a one-to-one conversation, open the new-chat menu, search for a user by their username and start a direct message. DMs are private — only the two participants see them — and persist across sessions. New messages show as an unread badge on the DM tab.

Group chats

Group chats let a handful of users talk privately in a named room. Create one from the new-chat menu by picking a name and adding users; each added user receives an invite that they can accept or decline. The creator can also delete the group, which removes it for every member.

Invites & unread state

Pending invites appear at the top of the chat sidebar with Accept and Decline buttons. The room sidebar shows an unread count against any conversation with new messages since your last visit.

16

Documentation window (DOCS)

DOCS is this same reference, available as a floating window inside the terminal. Type DOCS in the palette to open it. It is a singleton window and is fully scrollable; use your browser’s find shortcut (Ctrl+F or Cmd+F) to jump to a topic.

17

Batch charts

Batch chart windows are opened by the All buttons in Position Monitor and Aggregate. They render many charts at once inside a single scrollable window.

How they load

Charts render progressively in batches of five, so the first results appear quickly and the rest fill in as they’re fetched. Charts that are not currently visible are lazy-loaded on scroll — performance stays smooth even with dozens of contracts.

Resizing

Each chart has a drag handle at its bottom edge. Dragging it resizes every chart in the batch simultaneously; re-renders are deferred until you release the mouse.

Shared settings

The settings wheel on a batch window applies to every chart inside it — date range, lookback, colours, smoothing and style are shared. This keeps the whole batch visually consistent.

Exports

Batch windows support both screenshot and PDF exports. The PDF contains one page per chart; the screenshot captures the whole grid.

18

Settings wheels

Most windows expose a small gear icon in their title bar. Opening it reveals a settings panel scoped to that window only — changes apply to the current instance but do not leak to other open windows of the same type. That means you can run, for example, two Heatmap windows with different lookbacks and different colour schemes side by side.

Chart settings (POS / IDX / CMB / MOV / Batch)

SettingDescription
Date rangeStart and end dates; bounded by available history for that contract
Lookback (weeks)Rolling window used by the COT index calculation (1–500)
COT index bandsWidth of the variance bands drawn around the index (1–50)
Positioning styleHistogram (bars) or line
Index styleHistogram or line
SmoothingOptional smoothing for line styles
Panel ratioVertical split between the positioning and index panels in CMB
ColoursPer-category and open-interest colour pickers with hex input

Heatmap settings

Threshold mode, low/high thresholds and the two colour-gradient endpoints are all configured here, on top of the usual lookback setting.

19

Report-type selection

COT data comes in seven CFTC report variants. Every window that consumes COT data exposes a report-type selector so you can pick which variant to read from.

CodeNameNotes
LFOLegacy Futures OnlyClassic three-category breakdown: commercial, non-commercial, non-reportable
LCOLegacy CombinedLegacy categories with futures and options combined
DFODisaggregated Futures OnlyCommodities split into Producer/Merchant, Swap Dealer, Managed Money, Other Reportables
DCODisaggregated CombinedDisaggregated categories, futures + options
TFOTFF Futures OnlyFinancial futures: Dealer, Asset Manager, Leveraged Funds, Other Reportables
TCOTFF CombinedTFF categories, futures + options
CITSupplemental CITAdds a Commodity Index Trader slice to selected agricultural contracts

The COT Report window offers the full seven-type dropdown. Chart and heatmap windows offer the most common pair as a quick toggle — FO for futures-only and F+O for combined.

20

Screenshot & PDF exports

Every chart, batch and signal window can be exported for sharing or archiving. Look in the window’s title bar for two icons:

  • Screenshot — the camera icon downloads a PNG snapshot. Filenames include the ticker and date so exports stay self-describing.
  • PDF — the file-download icon generates a print-ready PDF. Batch and Aggregate windows produce multi-page PDFs (one chart per page); the signal scanner produces a formatted document listing long and short signals.

Exports run server-side so the image quality does not depend on your screen resolution.

21

Saved dashboards

A dashboard captures the entire state of your workspace — every window’s position, size, z-order and settings — under a name you choose. Loading a dashboard restores that layout exactly, so you can build dedicated setups for different workflows (a morning review, a positioning deep-dive, an alert monitor) and flip between them.

Managing dashboards

Open the save-and-load menu from the save icon in the top bar, or from the user menu under Saved dashboards.

ActionHow
SaveType a name in the input and press save to capture the current workspace
LoadClick any saved dashboard to restore that layout immediately
RenameDouble-click the dashboard name in the list to edit it in place
DeleteUse the remove action next to the dashboard
Last loadedThe most recently loaded dashboard is marked; it is auto-restored once per session on sign-in
22

User settings menu

The user menu is the user-icon on the far right of the top bar. It is the entry point for all account, billing and preference management.

Profile & username

Under Profile, you can edit your username and full name. Your email address is shown for reference but cannot be edited from here. Save-changes commits the update; the session is refreshed with the new values immediately.

Password

The profile view also contains a Change password section. Enter your current password followed by the new password twice to confirm.

Subscription & billing

Shows your plan, status badge (Active, Trialing, Cancelled or Past Due), remaining trial days if applicable, and the next billing date. The Manage subscription button opens the billing portal, where you can update your payment method, download invoices or cancel.

Preferences

Two preferences are controlled here:

  • Snap to align — mirrors the magnet toggle in the top bar.
  • Default lookback period — the default COT index lookback used when new Heatmap and COT windows are opened. Choose from 26, 52, 104 or 156 weeks.

Keyboard shortcuts reference

A compact list of the terminal’s shortcuts and command codes, for quick lookup without leaving the terminal.

Delete account

Under Delete account you can permanently close your account. This action is irreversible: your profile, saved dashboards, chat history, universes and subscription data are deleted. You must confirm with your current password; on success you are signed out and returned to the home page.

Sign out

Log out ends the session, clears local state and returns you to the sign-in page.

23

Magnet & snap

With snap mode on, windows align to the edges of other windows and to the top-bar boundary as you drag or resize them. It is a pixel-accurate snap with a 10-pixel threshold, so you can build tidy layouts without manually lining anything up.

Toggle snap from the magnet icon in the top bar, or from Preferences in the user menu. The setting is shared across every window type — charts, Position Monitor, Aggregate, Signal Scanner, COT Report, Heatmap, Risk Calculator, Movement Index, Term Structure, CFTC Schedule, Community Chat, Documentation and batch windows all respect the same snap flag.

24

Keyboard shortcuts

The terminal is built to be driven from the command palette, so there are only a small number of global keyboard shortcuts. All other interactions are button-driven or palette-driven.

ShortcutAction
TabOpen the command palette. With a contract highlighted in the palette, switches to chart-type selection.
EnterSelect the highlighted palette item.
Navigate palette results.
EscapeClose the palette, or back out of chart-type selection.
Double-click title barMaximise a window, or restore it to its previous size.
Right-click PM shortcut buttonCustomise which chart type that column opens.

Global shortcuts are suspended whilst you are typing in a text input (including the palette search, contract search, chat and settings fields) and during the initial loading animation.