Obelisk Terminal — Documentation

Qu'est-ce que le Terminal ?

Le Terminal Obelisk est une interface de trading dense, inspirée des terminaux Bloomberg et Refinitiv, conçue pour surveiller et gérer l'ensemble du capital déployé sur les 6 venues de trading actives simultanément.

Contrairement à l'interface DEX classique, le terminal est orienté gestion de portefeuille et monitoring professionnel : toutes les données critiques sont visibles en un coup d'œil, sans navigation.

Cas d'usage

• Surveiller les positions ouvertes sur toutes les venues depuis une seule vue
• Monitorer les métriques de risque (Sharpe, VaR, drawdown) en temps réel
• Analyser la performance relative par venue (ROI, win rate, P&L)
• Soumettre des ordres manuels avec paramètres SL/TP depuis le terminal
• Suivre l'historique d'exécution complet avec timestamps UTC
• Diagnostiquer l'état des services PM2 (mixbot, obelisk, supa)

Architecture technique

Quick Start

pm2 restart obelisk
pm2 logs obelisk --lines 20

https://obelisk-dex.pages.dev/terminal.html
# ou en local (si servi via wrangler dev) :
http://localhost:8788/terminal.html

Terminal Layout

Le terminal est organisé en 5 zones fixes + une top bar permanente :

Zones et dimensions

Keyboard Shortcuts

Le terminal est entièrement opérable au clavier. Les raccourcis ne fonctionnent pas si le focus est dans un champ de saisie.

Panel — Portfolio

Le panel gauche est le centre de contrôle financier. Il agrège toutes les données de capital et de risque de l'ensemble des venues.

Section CAPITAL

La barre de marge passe de gold à orange au-delà de 70% d'utilisation — signal de risque.

Section P&L

Section RISK

Voir la section Risk Metrics pour les définitions détaillées de chaque indicateur.

Section EXPOSURE

Visualise la direction du portefeuille :

Sparkline P&L 24H

Graphique canvas animé du P&L cumulé sur les 24 dernières heures (288 points max à 5min d'intervalle). La couleur de la courbe reflète le P&L en cours : vert si positif, rouge si négatif.

Panel — Open Positions

Table dense de toutes les positions ouvertes sur l'ensemble des venues. Chaque ligne est une position individuelle.

Colonnes

Code couleur des lignes

Tri

Cliquer sur l'en-tête d'une colonne pour trier. Ou utiliser les boutons en haut à droite du panel :

• SORT P&L — trie par P&L décroissant (les positions les plus profitables en premier)
• BY VENUE — trie alphabétiquement par venue

Fermeture de position

Cliquer sur CLOSE sur une ligne déclenche une confirmation + appel POST /api/trade/venue/close. Résultat affiché dans l'Execution Log.

Panel — Execution Log

Journal d'exécution temps réel. Chaque événement (ordre soumis, rempli, rejeté, erreur système) est enregistré avec timestamp UTC précis.

Format d'une entrée

09:46:12  BTC/USDC  [LONG]  APEX  Order filled — ID:ord_4f2a1b  +$0.103  ✓

Types d'entrées

Export

Cliquer EXPORT génère un fichier .tsv (Tab-Separated Values) importable dans Excel/Google Sheets avec colonnes : Time · Symbol · Side · Venue · Message · PnL.

FORMAT TSVTime      Symbol    Side  Venue  Message              PnL
09:46:12  BTC/USDC  LONG  APEX   Order filled — OK    0.103
09:44:51  ETH/USDC  SHORT DRIFT  Order filled — OK    0.081

Panel — Venue Matrix

Chaque carte de venue affiche l'état en temps réel de la plateforme et du capital déployé.

Structure d'une carte venue

EXEMPLE● APEX                 SONIC    $6.00
████████████████░░░░░             ← barre equity relative
pos: 2    +$0.032    +0.53%

System Health

Panel — Risk Dashboard R

Modal accessible depuis le bouton RISK ou la touche R. Présente les métriques institutionnelles de gestion du risque.

Les 6 métriques clés

Voir la section Risk Metrics pour les formules complètes. Résumé rapide :

Matrice de corrélation

Corrélation de Pearson des rendements journaliers par venue sur 30 jours glissants. Une corrélation proche de 1.0 = mauvaise diversification (les venues bougent ensemble). Idéalement les corrélations inter-venues doivent rester sous 0.5.

Panel — Order Entry N

Panneau flottant pour soumettre des ordres manuels directement depuis le terminal, sans passer par l'interface DEX.

Champs

Flow d'exécution

API — Overview

Le terminal communique avec le backend Obelisk via une API REST locale. Base URL : http://localhost:3001

Endpoints utilisés par le terminal

Source de prix externe

API — Equity & Positions

JSON{
  "equity": 28.45,
  "balance": 28.45,
  "pnl_today": 0.32,
  "pnl_total": 1.84,
  "positions": [
    {
      "id": "pos_abc123",
      "symbol": "BTCUSDC",
      "side": "long",
      "size": 5.0,
      "entryPrice": 84230,
      "markPrice": 84315,
      "pnl": 0.103,
      "leverage": 3,
      "venue": "apex",
      "liquidationPrice": 56153
    }
  ],
  "venueBreakdown": {
    "apex":    { "capital": 6.0, "equity": 6.12, "positions": 2, "pnl24h": 0.12 },
    "drift":   { "capital": 5.0, "equity": 5.03, "positions": 1, "pnl24h": 0.03 },
    "mux":     { "capital": 5.0, "equity": 4.97, "positions": 0, "pnl24h": -0.03 },
    "aster":   { "capital": 5.0, "equity": 5.08, "positions": 1, "pnl24h": 0.08 },
    "morpher": { "capital": 3.45, "equity": 3.41, "positions": 2, "pnl24h": -0.04 },
    "obelisk": { "capital": 4.0, "equity": 3.84, "positions": 0, "pnl24h": -0.16 }
  }
}

API — Orders

JSON{ "success": true, "orderId": "ord_4f2a1b", "venue": "apex", "pnl": null }

JSON{ "success": false, "error": "Insufficient margin", "code": 2080 }

JSON{ "success": true, "pnl": 0.103, "closedAt": 84315 }

API — Venue Stats

JSON{
  "venues": {
    "apex":  { "trades_24h": 12, "win_rate": 0.67, "pnl_24h": 0.32, "avg_rr": 3.1 },
    "drift": { "trades_24h": 8,  "win_rate": 0.62, "pnl_24h": 0.14, "avg_rr": 2.9 }
  },
  "total_trades_24h": 47,
  "total_pnl_24h": 0.89
}

JSON[
  {
    "name": "mixbot",
    "pm2_env": {
      "status": "online",
      "pm_uptime": 1710000000000,
      "restart_time": 2,
      "memory": 285000000
    }
  },
  { "name": "obelisk",    "pm2_env": { "status": "online" } },
  { "name": "supa-film",  "pm2_env": { "status": "online" } },
  { "name": "supa-science","pm2_env": { "status": "online" } }
]

Risk Metrics — Définitions

Toutes les métriques suivent les standards institutionnels utilisés par les hedge funds et family offices.

Modèle d'Exposition

Effective Leverage

Le levier effectif est calculé sur l'ensemble du portefeuille, pas par position individuelle. Un levier de 1.5x signifie que la stratégie est 1.5× exposée au marché par rapport au capital déployé.

Gross Notional = Σ all positions (long + short, valued at mark price)
Effective Leverage = Gross Notional / Total Equity

Configuration leverage par venue

Venues — Vue d'ensemble

Structure des Frais

Les frais de trading sont critiques pour la profitabilité HFT. Un fee de 0.1% sur 200 trades/jour = 20% du capital perdu quotidiennement.

Chains — Benchmarks

Glossaire Institutionnel

Terminologie utilisée dans le terminal, les métriques et l'API.

Configuration

Fichiers de configuration clés

Variables d'environnement backend

~/obelisk/.envPORT=3001
NODE_ENV=production
WALLET_ADDRESS=0x377706801308ac4c3Fe86EEBB295FeC6E1279140
ARBITRUM_RPC=https://arb1.arbitrum.io/rpc
BINANCE_WS=wss://stream.binance.com:9443/ws

Refresh intervals (terminal.html)

CONSTANTSconst REFRESH_MS = 5000;   // Portfolio + positions: toutes les 5s
const PRICE_MS   = 3000;   // Prix Binance: toutes les 3s
// Horloge UTC: 1s (setInterval)

Changelog