# Opentradex Dashboard

> Open a local web dashboard showing open positions, exposure, daily P&L, and recent trades. Invoke when the user says "dashboard", "open dashboard", "show my book", "pnl screen", or asks to visualise their paper-trading state. Runs a zero-dependency HTTP server on 127.0.0.1 and prints the URL.

- Skill: `deonmenezes/opentradex-dashboard` (Agent Skill)
- Install (CLI): `npx skillmds@latest add deonmenezes/opentradex-dashboard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/deonmenezes/opentradex-dashboard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: deonmenezes (https://skillmd.com/u/deonmenezes)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/deonmenezes/opentradex-dashboard

---


# OpenTradex — Local Dashboard

Spin up a local web dashboard that reads the paper-trading ledger and displays positions, exposure, and realized/unrealized P&L. Dark theme, auto-refreshes every 2 seconds.

User arguments: `$ARGUMENTS` — optional `--port N` (default 3300).

## Flow

1. Start the dashboard server in the background so the user's terminal stays free:
   !`node "${CLAUDE_PLUGIN_ROOT}/bin/tradex.js" dashboard $ARGUMENTS`
2. Once the server prints `OpenTradex dashboard running at http://127.0.0.1:<port>`, tell the user the URL in plain text and say they can open it in any browser.
3. If the port is already in use, re-run with `--port 3301` (or next free port) and inform the user.

## What the dashboard shows

- Open positions (rail, symbol, qty, entry, mark, unrealized P&L)
- Recent trades (last 20 realized)
- KPI cards: open count, exposure, daily realized, daily unrealized, daily total, panic cooldown
- Refresh button that re-marks open positions against live scans

## Rules

- Bind only to `127.0.0.1` — never expose externally.
- Don't open the URL automatically; print it and let the user click/paste.
- Don't place orders from here — dashboard is read-only plus a mark-refresh button.