Trading Interface
The GoDark web application at app.godark-dex.com is the primary interface for placing and managing trades. This page describes the trading UI — layout modes, order entry panels, and market data views. For programmatic access, see Programmatic Access.
Layout Modes
On desktop, you can choose from three resizable layouts. Your selection is saved in the browser and restored on your next visit. Balanced is the default.
| Layout | What you see |
|---|---|
| Basic | Chart and working orders in the main area; order entry above account metrics on the right. No reference order book or reference trades. |
| Balanced | Account metrics above order entry on the left; reference order book and reference trades stacked beside the chart; working orders below. |
| Pro | Chart with a tabbed reference order book / reference trades panel beside it; order entry above account metrics on the right; working orders below. |
To change layout, use the Layout control in the header. Each option shows a small preview of the panel arrangement. Layout modes are available on desktop only — see Responsive Layouts for mobile and tablet.
Order Entry Panels
The same order-entry panel is used across desktop layouts. Its order-type tabs are:
- Market — immediate-or-cancel; IOC is enforced by the venue.
- Limit — supports GTC, IOC, FOK, and GTD.
- Peg — supports GTC and GTD.
- Stop Market / Stop Limit — shown through the Stop menu when the corresponding feature is enabled.
The panel also supports per-instrument leverage (capped by the instrument's published max_leverage), optional take-profit / stop-loss controls, and compatible execution attributes such as reduce-only, post-only, and minimum fill. Availability depends on the selected order type; the UI does not offer invalid combinations.
All desktop layouts include a Working orders table with real-time fill updates below the chart.
Chart and Reference Data
| Component | Source |
|---|---|
| Price chart | GoDark's self-hosted chart, built with KLineCharts and fed by Pyth data. It includes interval, chart-style, data-source, timezone, indicator, overlay, and settings controls. |
| Reference order book | Aggregated depth from Hyperliquid and Binance. You can choose which venues to display. |
| Reference trades | Recent trades from Hyperliquid and Binance. You can choose which venues to display. |
| Mark / oracle price | Pyth market data used by the trading and risk paths |
Reference order book and trades show activity from other venues for comparison. They do not represent GoDark's internal order book.
Margin Health
The web UI displays a margin health bar and tier banners that mirror the sequencer's six-band margin ladder (Healthy through T3). Colors and thresholds match the backend liquidation monitor. See Margin & Liquidation for tier definitions and what happens at each level.
Responsive Layouts
On mobile and tablet, desktop layout modes are not used. The interface switches to compact, tabbed views of the same trading features.
| Viewport | Navigation | Order panel |
|---|---|---|
| Mobile | Trade, Chart, Order book, Account, Positions | Compact order entry |
| Tablet | Chart and working orders on the left; order entry on the right | Compact order entry |
On mobile, the Order book tab switches between reference order book and reference trades.