Documentation
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
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.
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.
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.
Every window is reachable by typing a short code into the palette:
| Code | Window | Description |
|---|---|---|
| CMB | COT Combined View | Positioning bars and COT index lines on a shared axis |
| IDX | COT Index | Normalised 0–100 index for each trader category |
| POS | COT Positioning | Net positions by trader category |
| MOV | COT Movement Index | Week-over-week change in COT index values |
| COT | COT Report | Full CFTC report tables, all seven report types |
| SGL | COT Signal | Cross-market signal scanner |
| HMP | COT Heatmap | Grid of COT index values across every contract |
| AGG | COT Aggregate | Combine multiple contracts into a single chart |
| PM | Position Monitor | Watchlist table with chart shortcuts and saved universes |
| RISK | Risk Calculator | Position sizing and stop-loss calculator |
| TERM | Term Structure | Futures price curve across delivery months |
| SCH | CFTC Release Schedule | Calendar of COT report release dates |
| CHAT | Community Chat | Public rooms, direct messages and group chats |
| DOCS | Documentation | This reference, in a floating window |
| Key | Action |
|---|---|
| Tab | Open the palette, or enter chart-type selection whilst a contract is highlighted |
| Enter | Select the highlighted item |
| ↑ ↓ | Navigate results |
| Escape | Close the palette or go back to search |
The terminal uses a floating-window interface. You can open, move, resize and close any number of windows.
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.
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.
Click any window to bring it to the front. Newly opened windows always appear on top of existing ones.
Click the × icon in any window’s title bar.
The top bar spans the top of the workspace. From left to right, it contains:
Click the search bar or press Tab to open the command palette.
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.
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.
The magnet icon toggles window snapping on and off. See Magnet & snap for details.
A save icon beside the magnet opens the Saved dashboards menu — capture the current layout as a named dashboard or load an earlier one.
The user icon on the far right opens the user settings menu — your profile, subscription, preferences, shortcuts reference, delete-account option and sign-out.
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:
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.
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.
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.
| Category | Colour | Description |
|---|---|---|
| Commercials | Red | Hedgers — producers and consumers of the underlying |
| Large Speculators | Blue | Institutional traders — funds and managed money |
| Small Speculators | Yellow | Smaller and retail traders |
| Open Interest | Green | Total outstanding contracts, shown as an optional reference line |
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.
| Setting | Description |
|---|---|
| MOV lookback | Number of weeks between the two index values compared (default 6) |
| Bands | Threshold bands around zero, marking notable movement levels (default ±40) |
| Style | Histogram or line |
| Smoothing | Optional moving-average smoothing on the line style |
| Base lookback | The underlying COT Index lookback period, inherited from chart settings |
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.
All seven CFTC report variants are available from the report-type selector:
| Code | Report |
|---|---|
| LFO | Legacy Futures Only |
| LCO | Legacy Combined (futures + options) |
| DFO | Disaggregated Futures Only |
| DCO | Disaggregated Combined |
| TFO | Traders in Financial Futures (Futures Only) |
| TCO | Traders in Financial Futures (Combined) |
| CIT | Supplemental Commodity Index Trader |
Toggle each section independently using the header buttons. Each one is colour-coded and renders in its own set of columns:
| Section | Contents |
|---|---|
| POS | Positions — long, short, spreading and net, by trader category |
| CHG | Changes — week-over-week change in each position field |
| %OI | Percent of total open interest held by each category |
| TRD | Number of reportable traders in each category |
| CON | Concentration ratios — top four and top eight trader holdings |
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.
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.
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.
| Setting | Description |
|---|---|
| Generator | The trader category whose index threshold triggers the signal |
| Contributors | Additional trader categories that must also confirm the signal |
| Low threshold | Minimum COT index fill (0–100%) for a long signal |
| High threshold | Maximum COT index fill (0–100%) for a short signal |
| Base lookback | Weeks of history used to calculate the COT index (default 52) |
| Column lookbacks | Additional timeframes shown as columns (e.g. 13w, 26w, 52w, 104w, 156w) |
| Report type | LFO, LCO, DFO or DCO — which CFTC report feeds the scan |
| Universe | Optional — restrict the scan to a saved Position Monitor universe |
After clicking Generate, the result splits into two tables:
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.
The SGL window supports screenshot and PDF exports of the result tables via the icons in its title bar.
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.
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).
| Control | Description |
|---|---|
| Report type | Toggle between LFO (futures only) and LCO (combined) |
| Lookback | Index calculation window in weeks (1–200) |
| Asset-class filter | Limit rows to a single class (Currencies, Metals, Grains, Rates, …) |
| Universe | Restrict rows to contracts in a saved Position Monitor universe; pick “All contracts” to remove the filter |
| Column sort | Click a column header to sort by that category’s index, ascending or descending |
| Hover tooltip | Hover any cell to see the exact index value, net positioning and week-over-week change |
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.
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.
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.
| Column | Description |
|---|---|
| Ticker | Contract symbol — click to re-search |
| Name | Full contract name |
| Col 1 | Shortcut button — defaults to POS |
| Col 2 | Shortcut button — defaults to IDX |
| Col 3 | Shortcut button — defaults to CMB |
| Remove | Delete the row |
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.
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.
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).
| Action | How |
|---|---|
| Create | Open the universe menu, type a name and press Enter |
| Open | Click a name in the universe menu to load it into the current PM instance |
| Switch active | Use the tabs at the top of the PM window to flip between opened universes |
| Rename | Double-click a name in the universe menu to edit it inline |
| Delete | Delete action in the universe menu — removes the universe from the server |
| Close in window | Close the tab — the universe is unchanged, just not loaded in this instance |
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.
Click New Group to create an empty group, then click its name to rename it. Groups are collapsible via the arrow on the left.
Inside each group, the “+ Add contract…” input gives you two paths:
When every contract in a group belongs to the same asset class, the group is auto-renamed to that class (e.g. “Currencies”).
| Button | Action |
|---|---|
| POS | Open an aggregate Positioning chart for the group |
| CMB | Open an aggregate Combined chart for the group |
| All | Batch-generate the selected chart type for every non-empty group at once |
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.
| Field | Description |
|---|---|
| Contract | Type a ticker or CFTC code — multiplier, tick size and contract unit are auto-filled from the spec database |
| Total capital | Account size in dollars |
| Risk % | Percentage of capital you are prepared to risk on this trade |
| Entry price | Your planned entry |
| # contracts / stop | One or the other, depending on mode |
| Contract multiplier | Auto-filled from specs; can be overridden manually |
| Tick size (MPF) | Minimum price fluctuation — used to round the resulting stop to a valid price |
| Direction | Long or short |
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.
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.
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.
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.
Three public rooms are always available:
| Room | Purpose |
|---|---|
| General | Open discussion amongst ./sentral users |
| Bugs | Reporting issues and tracking fixes |
| Features | Ideas, feedback and feature requests |
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 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.
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.
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.
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.
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.
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.
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.
Batch windows support both screenshot and PDF exports. The PDF contains one page per chart; the screenshot captures the whole grid.
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.
| Setting | Description |
|---|---|
| Date range | Start and end dates; bounded by available history for that contract |
| Lookback (weeks) | Rolling window used by the COT index calculation (1–500) |
| COT index bands | Width of the variance bands drawn around the index (1–50) |
| Positioning style | Histogram (bars) or line |
| Index style | Histogram or line |
| Smoothing | Optional smoothing for line styles |
| Panel ratio | Vertical split between the positioning and index panels in CMB |
| Colours | Per-category and open-interest colour pickers with hex input |
Threshold mode, low/high thresholds and the two colour-gradient endpoints are all configured here, on top of the usual lookback setting.
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.
| Code | Name | Notes |
|---|---|---|
| LFO | Legacy Futures Only | Classic three-category breakdown: commercial, non-commercial, non-reportable |
| LCO | Legacy Combined | Legacy categories with futures and options combined |
| DFO | Disaggregated Futures Only | Commodities split into Producer/Merchant, Swap Dealer, Managed Money, Other Reportables |
| DCO | Disaggregated Combined | Disaggregated categories, futures + options |
| TFO | TFF Futures Only | Financial futures: Dealer, Asset Manager, Leveraged Funds, Other Reportables |
| TCO | TFF Combined | TFF categories, futures + options |
| CIT | Supplemental CIT | Adds 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.
Every chart, batch and signal window can be exported for sharing or archiving. Look in the window’s title bar for two icons:
Exports run server-side so the image quality does not depend on your screen resolution.
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.
Open the save-and-load menu from the save icon in the top bar, or from the user menu under Saved dashboards.
| Action | How |
|---|---|
| Save | Type a name in the input and press save to capture the current workspace |
| Load | Click any saved dashboard to restore that layout immediately |
| Rename | Double-click the dashboard name in the list to edit it in place |
| Delete | Use the remove action next to the dashboard |
| Last loaded | The most recently loaded dashboard is marked; it is auto-restored once per session on sign-in |
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.
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.
| Shortcut | Action |
|---|---|
| Tab | Open the command palette. With a contract highlighted in the palette, switches to chart-type selection. |
| Enter | Select the highlighted palette item. |
| ↑ ↓ | Navigate palette results. |
| Escape | Close the palette, or back out of chart-type selection. |
| Double-click title bar | Maximise a window, or restore it to its previous size. |
| Right-click PM shortcut button | Customise 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.