THESIS
from zip to your own desk.
Everything you need to install, configure, brand and host your own Hyperliquid trading desk and its operator admin. Read it top to bottom the first time. After that, press / and search.
01What you bought
AI tools were used to assist with parts of the code, documentation and graphics of this item. The author directed and reviewed the work. The item's one AI feature is the optional chart-to-rules reader, which sends a chart image and your note to the Anthropic Claude API on the API key you enter yourself and returns a rule set you can read, edit and backtest; without a key it stays off and the rest of the desk works.
THESIS is a web desk for Hyperliquid perpetual futures. A user starts from a template, writes rules in the visual or JSON editor, or (optionally, with your Anthropic key) lets Claude turn a chart or a screenshot into an exact rule set in a strict schema. The desk backtests the rules on real Hyperliquid candles with fees and funding, a robustness lab grades them A to F, and the user runs them as paper, testnet or mainnet from their own browser tab.
It is a tool for testing and running rules the user decides on. It does not pick trades, predict prices or promise any result.
It is non-custodial: the user's wallet approves a short-lived Hyperliquid agent key that is created inside the browser tab. No server ever holds a key, signs or relays an order.
| Part | Address | What it is |
|---|---|---|
| Landing page | / | Public page with live Hyperliquid tickers. Copy and FAQ are edited in the admin. Source: index.html, src/landing/. |
| Desk | /app | The trading desk: Build, Test and Run workspaces. Source: app.html, src/. |
| Operator admin | /admin | The MIKODES Admin Kit in packages/admin-kit (the author's own code, shipped with the item), with THESIS settings declared in src/admin/manifest.ts. |
| Server | /api/*, /admin/api/* | One handler (server/app.ts) that runs as a Node process (server/node.ts) or as a Vercel function (api/[...path].ts). It serves settings and calls Claude. It never signs orders. |
THESIS can place real orders with real money. Mainnet is off on a fresh install. When you switch it on (Admin → Trading → Mainnet trading) and a user starts a mainnet run, the desk places orders automatically on the rules that user approved, with the user's own key, from the user's browser. Losses are possible and can be fast: leveraged perpetual futures can lose the whole margin of a position. Backtests and lab grades describe the past only; no return is promised. Automated execution and fees on executed trades may be regulated where you or your users live. The safest way to use the package is as a self-hosted tool for your own account. If you host it for the public, get legal advice first. These docs are not legal or investment advice.
02Pick your path
How the parts talk to each other (and what never touches your server) is drawn on Architecture.
03What is in the package
| Folder or file | What it is |
|---|---|
index.html, app.html | The two pages Vite builds: landing and desk. |
src/strategy/ | Rule schema, indicators and the engine. engine.ts and policy.ts are used unchanged by the backtest and the live runner. |
src/backtest/, src/lab/ | Backtest with fees, slippage and funding; the robustness lab (walk-forward, Monte Carlo, sensitivity, look-ahead check, grade A–F). |
src/live/, src/hl/ | Runner, brokers (paper and Hyperliquid), risk limits, journal, drift, Telegram alerts; Hyperliquid market data and order signing. |
src/ui/ | Desk interface. |
src/shared/settings.ts | Every operator setting, its default and its allowed range. |
src/admin/, server/admin-kit.ts | Admin manifest, the mapping to desk settings, checks, revenue and metrics. |
server/, api/ | Node server and the Vercel function. |
packages/admin-kit/ | The admin kit: contract/ and server/ (TypeScript), the built console ui/ (not minified) and its source ui-src/, LICENSE.md (your item licence) and package.json. Leave it as delivered; updates arrive with item updates. |
test/, scripts/ | Automated tests (pnpm test) and smoke scripts. |
.env.example | Template for the server settings. You copy it to .env. |
vercel.json | Build command, rewrites and security headers for Vercel. |
docs/API.md | The HTTP API, for developers. |
Hosting (Vercel or a Node server), a Postgres database if you host on Vercel, an Anthropic API key if you want AI chart reading, a Hyperliquid account if you want to earn a builder fee, and your own terms and risk notice. None of these are part of the purchase. The full list, with who pays for each, is on Costs and services.
04Try it before you install
The public demo, thesis-demo.mikodes.com, shows the desk in a laptop frame; thesis-demo.mikodes.com/app/ opens the desk on its own. The demo replays real Hyperliquid market data captured on 2026-11-09, so its prices do not move; on your own install the desk streams live data from Hyperliquid. Paper mode needs no wallet and no deposit. A read-only operator console runs at thesis-demo.mikodes.com/admin: the demo account is printed on its sign-in screen and every write is refused. The full console is described in Admin panel and runs on your own computer a few minutes after install (Quick start).
05How to read these docs
- Dark boxes are commands. Press Copy in the corner and paste them into a terminal opened in the project folder.
- Grey text after
#is an explanation. The Copy button leaves it out. - Text in angle brackets, like
<your-domain>, is a placeholder. Replace it, brackets included. - Paths start at the project folder: the
sourcefolder of your download, the one withpackage.json. The download also holdsdocumentation(these pages) andlicenses. - Required marks steps you cannot skip; Optional marks the rest.