Open source · MIT · checked 13 Nov 2026
Your own Hyperliquid trading terminal, with an AI agent that reads the chart and suggests trades but never places them. You host it and you confirm every order.
View on GitHubgit clone https://github.com/rc-dran/self-hosted-perp-dex.git
Self-Hosted Perp DEX with AI Agents is an open-source (MIT) trading terminal for Hyperliquid perpetuals that you run yourself. It has a live chart with five indicators, a trade ticket, and Jarvis, an AI agent that reads the chart and suggests an entry, stop and target. Jarvis never places an order; you confirm every trade. One OpenFinance key runs both the trading and the AI. Deploy it with Vercel in about a minute, build it with no code on OpenFinance Mainframe, or run it on your own computer. Hosting, charts, market data and Jarvis's built-in mode are free. Each Hyperliquid trade costs 2.5 basis points (0.025%) to OpenFinance, plus Hyperliquid's own fees. There is no KYC on OpenFinance.
Last checked 13 Nov 2026. This page is published by OpenFinance, which provides the trading and AI key this terminal uses, and the terminal's source code is maintained by the OpenFinance team. The software is free to host and run. Fees are listed below with sources. Nothing here is investment advice.
| Self-Hosted Perp DEX with AI Agents | |
|---|---|
| What it is | A Hyperliquid trading terminal you host: chart, AI agent, trade ticket, account panel |
| Markets | 300+ Hyperliquid perps: crypto, plus US stocks, indices, commodities and FX through HIP-3 |
| AI | Jarvis: a free built-in engine, or 8 models from Anthropic, OpenAI, Google, xAI and DeepSeek |
| Who places orders | You. Jarvis only advises; the ticket has a confirm step |
| Withdrawals | Blocked in the app. Its proxy allows a short route list, and withdrawals are not on it |
| Your key | Kept in your browser tab only, gone when you close it |
| Cost | Free to run. 0.025% to OpenFinance per Hyperliquid trade, plus Hyperliquid's fees |
| Licence and code | MIT, TypeScript, React and Vite, on GitHub |
| Try it first | Live demo: chart, indicators and Jarvis, no key, analysis only |
What you get
This is your own copy of a Hyperliquid trading terminal. It is not a hosted exchange, and it is not a bot that trades while you sleep. Orders are real: they go to Hyperliquid from your own OpenFinance account.
300+ markets (crypto, US stocks, indices, commodities and FX) on every timeframe from 1 minute to 1 month, with five indicators you turn on and off: EMA bands, RSI with divergences, MACD, auto-anchored Fibonacci, and buy and sell zones. Market data comes straight from Hyperliquid, so you can look without a key.
Ask "Should I trade?" and Jarvis reads the live chart and indicators, then gives a scored call: long, short or wait, with an entry, stop loss, target, risk to reward and the reasons. Ask "why?" about any indicator and it explains in plain words. The built-in engine is free and needs no key; the eight AI models use OpenFinance AI credits.
Market orders with leverage, cross or isolated margin, take-profit and stop-loss, a liquidation estimate and a confirm step. Nothing is sent until you press confirm. If the price moves more than 1% between your confirm and the send, the ticket stops and no order goes out.
Positions, balances, open orders and recent trades in the same screen, with close and cancel buttons. Fund the account with the Deposit button (USDC) when you are ready to trade.
How it is put together
Market data and your account's positions and balances need no key: your browser reads them straight from Hyperliquid. Anything that uses your key goes through /api/of, the allowlisted edge function, to OpenFinance, which runs the AI models and places orders on your Hyperliquid account. The proxy stores nothing.
/api/of on your copyAllowlisted edge function
OpenFinanceRuns the AI and the orderMarket data never passes through OpenFinance: your browser reads it from api.hyperliquid.xyz directly.
This terminal is a front end you host. It is not an MCP server. To trade from Claude, ChatGPT, Grok or another assistant directly, add https://api.openfinance.tech/agent/mcp and sign in with OAuth or send an x-api-key header; see the MCP server install guides.
Deploy
Pick the path that fits how you work. None of them asks you to put secrets in project settings, because the app has no environment variables.
| Path | Pick this if | Code needed | Time | Cost to deploy |
|---|---|---|---|---|
| Deploy on OpenFinance | You don't code and want to change the app by chatting | None | A few minutes | The build uses AI credits |
| Deploy with Vercel | You want this exact code live now | None | About 1 minute | Free |
| Run on your computer | You want to try it or change the code | Node.js 20 or newer | About 2 minutes | Free |
| Host it yourself | You want it always on, on your own machine or server | Node.js 20 or newer | About 5 minutes | Free |
You need Node.js 20 or newer.
Deploy with Vercelgit clone https://github.com/rc-dran/self-hosted-perp-dex.git
cd self-hosted-perp-dex
npm install
npm run dev
Then open http://localhost:3143. The chart and Jarvis's built-in mode work without a key. Market data comes straight from Hyperliquid, so your network must reach api.hyperliquid.xyz.
To keep it running on your own computer or a server, build it once and serve it:
npm start
This serves the app at http://localhost:3143 with the same protected /api/of route as the Vercel version. It runs on Vite's preview server, which is fine for personal use but is not a hardened production server. Add -- --host to open it from your phone or another device on the same network. If you open it to the internet, put it behind HTTPS (for example Caddy or a Cloudflare Tunnel) and keep the link to yourself, because your key travels with each trading or AI request.
The front end is a static build, so it also runs on Netlify, Cloudflare Pages or another host. Port the short edge function api/of.ts to that host's function format, and keep api/_allow.ts exactly as it is.
Before you start
The chart, indicators and Jarvis's built-in mode work on a fresh copy, and on the live demo. Add a key only when you want to trade or use an AI model.
Never into a demo someone else hosts, a random fork, or a screenshot request.
It lives in the tab's session storage, so closing the tab clears it.
The app has no environment variables, on purpose. If a host's form asks for secrets, you don't need any.
The key is sent with each trading or AI request to your copy's /api/of route.
Check that your network can reach api.hyperliquid.xyz. Market data does not go through OpenFinance.
The picker lists the 250 busiest markets first; type a name to find the rest.
After a Mainframe deploy you can restyle the terminal or change the default market by asking, instead of editing files.
Safety
Three rules are built into the code, and you can read each one in the repo.
Jarvis has no way to place an order. It returns text: a call with an entry, stop and target. Orders only come from you: the trade ticket after you press confirm, or the Close button on an open position after you click it twice. The ticket refuses to send if the price has moved more than 1% since you confirmed.
Every request that uses your key goes through /api/of, a small edge function that forwards only the routes below to OpenFinance. Everything else gets a 404, including withdrawals and transfers. The list is in api/_allow.ts.
Your OpenFinance key (it starts with open_) is kept in the browser tab's session storage. It is never written into the code, the build or environment variables, and the proxy doesn't log it. Every trading or AI request needs a valid key; there is no keyless trading. There is no KYC on OpenFinance.
| Method | Route | Used for |
|---|---|---|
| POST | agent/v1/chat/completions | Jarvis with an AI model |
| GET | agent/chat/credits | AI credit balance |
| GET | agent/trading/deposit-address | Your deposit address |
| GET, POST | agent/trading/abstraction | One-time account setup |
| POST | agent/trading/leverage | Leverage and margin mode |
| POST, DELETE | agent/trading/orders | Place and cancel orders |
Everything else gets a 404. Read the list in api/_allow.ts.
This is a different shape from letting a chat assistant place orders through the OpenFinance MCP server: in this terminal the AI cannot press confirm for you. For a longer look at agent risk, read Is agentic trading safe?. To report a security problem, use GitHub's private advisory form on the repo, as described in its SECURITY.md.
Costs
Fees change. Numbers below were read on 13 Nov 2026; check each source before you trade.
| Item | Cost |
|---|---|
| The software, hosting on Vercel, charts, market data and Jarvis's built-in mode | Free (MIT licence) |
| Each Hyperliquid trade | 2.5 basis points (0.025%) to OpenFinance, plus Hyperliquid's own fees |
| Jarvis with an AI model | AI credits ($1 = 10 credits). Each answer costs from $ (cheapest model) to $$$$ (priciest); see the models table below |
| Deploy on OpenFinance (Mainframe) | The build uses AI credits |
Hyperliquid's own fees depend on your rolling 14-day volume (Hyperliquid docs). At the base tier a perp market order pays 0.045% (taker) and a resting limit order 0.015% (maker). HIP-3 markets (stock, FX and commodity perps) can carry higher fees, so check the estimate in the ticket.
Leverage is set in the ticket and follows Hyperliquid's limit for each market (40x on BTC on 11 Nov 2026), which falls as the position grows (margin tiers). The 25 basis point OpenFinance fee for Polymarket and onchain swaps does not apply here, because this terminal trades only Hyperliquid perps. We don't claim this is the cheapest way to trade: Hyperliquid's own app skips OpenFinance's fee.
Under the hood
| Model | Best for | Cost per answer |
|---|---|---|
| Built-in engine | Instant rule-based reads, no key | Free |
| Claude Haiku 5.5 (default) | Quick everyday reads | $ |
| GPT-5.6 Luna | Short, to the point | $ |
| DeepSeek V4.1 Flash | Long explanations at the low end of the credit range | $ |
| Gemini 3.8 Flash | Fast with some thinking | $$ |
| Grok 4.7 | Blunt takes | $$ |
| Claude Sonnet 5.5 | Sharper trade plans | $$$ |
| GPT-5.6 Terra | Structured strategy | $$$ |
| Claude Opus 5.5 | Deepest analysis | $$$$ |
| Indicator | What it shows |
|---|---|
| EMA bands | A 30 EMA with a 2.5σ envelope, and a dot when a candle closes outside it |
| RSI and divergences | RSI(14) with bullish and bearish divergence tags between swing pivots |
| MACD | MACD(12, 26, 9) with histogram and crossovers |
| Fibonacci | Auto-anchored to the biggest recent swing, with the 0.618 to 0.65 golden pocket |
| Buy and sell zones | The nearest swing pivots above and below the price, sized by ATR |
Use cases
| You want to... | How it helps |
|---|---|
| Get a second opinion before a trade | Ask Jarvis "Should I trade?" for an entry, stop, target and the reasons |
| Trade NVDA, gold or EUR/USD next to BTC | HIP-3 markets sit in the same picker, on the same account |
| Give a community its own terminal | Deploy it on your own domain and restyle it by asking in chat |
| Learn what the indicators mean | Toggle one and ask Jarvis "why?". The built-in mode is free and needs no key |
| Build on OpenFinance from a browser | A working reference: the key stays in the tab, the proxy is allowlisted, withdrawals are blocked |
| If you want | Use |
|---|---|
| A chart, an AI read and a confirm button in one screen you own | This self-hosted terminal |
| Trade from inside Claude, ChatGPT, Grok or Cursor by chat | The OpenFinance MCP server |
| TradingView data next to trade execution in a chat | TradingView MCP plus OpenFinance |
| Hyperliquid with no extra layer and no OpenFinance fee | Hyperliquid's own app with your own wallet |
| Options | The OpenFinance app, through your own IBKR or Robinhood account. Not this terminal, and not the MCP |
Risk note
Leverage can lose you more than you put in, and a small move can liquidate a position. The AI can be wrong. Nothing on this page is investment advice or a promise of profit, and you are responsible for every order you confirm. Check that trading these markets is legal where you live.
An open-source trading terminal for Hyperliquid perpetual markets that you run on your own computer, server or Vercel project. You get a live chart, an AI agent called Jarvis, and a trade ticket. Orders go to Hyperliquid from your own OpenFinance account.
It is a self-hosted front end for Hyperliquid, which is a decentralised perp exchange on its own chain. The terminal doesn't run an order book; it sends your orders to Hyperliquid through OpenFinance.
No. Jarvis gives a scored opinion with an entry, stop and target, and it has no way to place an order. You confirm every trade in the ticket, and the ticket refuses to send if the price moved more than 1% after you confirmed.
No. The app can place and cancel orders, set leverage, read your AI credits, show your deposit address, and switch your account to Hyperliquid's unified mode once, automatically. Anything outside that short route list gets a 404, including withdrawals. The list is in the public file api/_allow.ts. The key itself can withdraw, so only paste it into a copy you deployed yourself.
Yes. The live demo shows the chart, indicators and Jarvis with no key and no sign-up, and never places orders. It runs under the project's earlier name, TradeIndicator AI. A fresh copy you run yourself works the same way until you add a key.
No. Press the Deploy with Vercel button on the repo, or let OpenFinance Mainframe build and ship it after you connect Vercel and GitHub. Code is only needed if you want to change the source yourself.
The software, charts, market data and Jarvis's built-in mode are free. Each Hyperliquid trade costs 2.5 basis points (0.025%) to OpenFinance, plus Hyperliquid's own fees. The optional AI models use OpenFinance AI credits ($1 = 10 credits), and a Mainframe deploy uses AI credits for the build.
Not on OpenFinance. You still need to check that trading these markets is legal where you live.
It stays in your browser tab's session storage and is cleared when you close the tab. It is never written into the project, and it only travels to your own copy's /api/of route, which forwards it to OpenFinance. Only paste it into a copy you deployed yourself.
Hyperliquid perpetuals: more than 300 markets, including crypto and HIP-3 perps on US stocks, indices, commodities and FX. This terminal does not trade Polymarket, onchain swaps, spot or options.
No. Options are available only in the OpenFinance app, through your own connected IBKR or Robinhood account. They are not in this terminal or in the OpenFinance MCP.
This is a terminal you host, with a chart and a confirm button you press yourself. Trading with Claude or Grok uses the OpenFinance MCP server inside a chat app, where you also confirm orders. The difference is that here the AI cannot press confirm at all.
A free built-in engine, or eight models: Claude Haiku 5.5 (the default), GPT-5.6 Luna, DeepSeek V4.1 Flash, Gemini 3.8 Flash, Grok 4.7, Claude Sonnet 5.5, GPT-5.6 Terra and Claude Opus 5.5.
Yes. It is MIT-licensed, so you can fork it and change anything. If you deployed through Mainframe you can also change it by chatting, for example asking for limit orders or a different default market.
No. Leverage can lose you more than you put in, and the AI can be wrong. You are responsible for every order you confirm.
Sources
api/_allow.ts, SECURITY.md, MIT licenceBy the OpenFinance team · Last updated · Not financial advice. Hyperliquid is a trademark of its owner; OpenFinance is not affiliated with Hyperliquid.