Documentation · v1.0.0

Papurrr Trade docs

Papurrr turns app.hyperliquid.xyz into a paper trading account. You trade through Hyperliquid's own interface. Papurrr catches each order in your browser, fills the order against the live market, and feeds the result back into Hyperliquid's tables.

Install

Papurrr works in Chrome 111 or newer. Brave, Edge and Arc install from the Chrome Web Store too.

Open Papurrr Trade on the Chrome Web Store.
Click Add to Chrome, then Add extension.
Pin Papurrr from the puzzle icon in your toolbar so the popup stays one click away.
Reload any Hyperliquid tab you already had open.

Open in the Chrome Web Store

Updates

Chrome installs new versions on its own, usually within a few hours of a release. Your paper account, positions and history carry over.

Quick start

Open app.hyperliquid.xyz/trade. The Papurrr icon shows a pink ON badge.
Connect a wallet. Hyperliquid hides the order form until a wallet is connected. A fresh wallet with zero balance works. Without a Hyperliquid account yet, create one through Papurrr for 4% off live trading fees.
Click Enable Trading and sign. The signature costs nothing, and Papurrr answers the request locally. Nothing reaches the exchange.
Your account shows $10,000. Pick a market, set leverage, and place an order the usual way.

TipChange your balance any time from the popup under Adjust balance. To wipe everything and start over, type an amount next to Reset and confirm.

Placing orders

Every order type from the Hyperliquid order form works on the main perp markets.

Order	How Papurrr fills the order
Market	Walks the live L2 order book level by level up to Hyperliquid's slippage limit. Your fill price is the size-weighted average across the levels you consumed. Taker fee.
Limit (GTC)	Takes any liquidity inside your price first. Whatever remains rests on the paper book and fills at your limit price once the mid price reaches your price. Maker fee on the resting part.
Post only (ALO)	Rejected if the order would cross the spread on entry, same as Hyperliquid. Otherwise rests like a GTC limit.
IOC	Fills whatever the book offers inside your price. The rest cancels.
Reduce only	Size gets clipped to your open position. Rejected when no position exists on the opposite side.

Rejections you might see

Order must have minimum value of $10. Hyperliquid's minimum order size.
Insufficient margin to place order. The order needs more margin than your available balance.
Reduce only order would increase position. No position to reduce on this side.
Post only order would have immediately matched Your ALO price crossed the spread.

TP/SL and triggers

Position TP/SL

Set from the TP/SL column in the Positions tab. A position TP/SL always covers your full position, even after you add or trim size. Closing the position cancels the pair.

TP/SL on an entry order

Tick TP/SL in the order form before you submit. The TP and SL wait until the entry fills. Cancel the entry and both cancel with the entry.

Trigger rules

Triggers watch the live mid price and check several times per second.
Market triggers fill against the live order book the moment the trigger fires.
Limit triggers turn into a resting limit order at your limit price.
Drag a TP, SL or limit line on the chart to move the order. Papurrr updates the order.

Leverage and margin

New markets default to 20x cross, or the market max if the max sits below 20x. Change leverage and margin mode from the buttons above the order form. Papurrr blocks a switch between cross and isolated while a position is open, same as Hyperliquid.

// margin a position locks initial margin = size × entry price ÷ leverage // Hyperliquid's maintenance rate maintenance rate = 1 ÷ (2 × market max leverage) maintenance margin = size × mark price × maintenance rate

Isolated positions hold their own margin. Add or remove margin from the Positions tab. Cross positions share your whole cross balance.

Liquidation

Papurrr checks every position on each price update.

Isolated: once position equity reaches maintenance margin, the position closes and you lose the margin left in the position.
Cross: once cross account value reaches total cross maintenance margin, every cross position closes.

// side = 1 for long, −1 for short liq price = mark − side × available margin ÷ size ÷ (1 − maintenance rate × side)

Papurrr tracks the highest and lowest price between checks, so a wick through your liquidation level counts even if your tab sat in the background. The price shown rounds against your position, so touching the number shown liquidates you.

Liquidation fills show in Trade History with the liquidation flag and no trading fee.

Funding

Funding settles every hour on the hour, like Hyperliquid. Papurrr refreshes live funding rates and oracle prices every minute.

payment = position size × oracle price × hourly funding rate

A positive rate means longs pay shorts. Payments come out of your cross balance, or out of the position margin for isolated positions. Every payment shows in the Funding History tab and adds to the position's funding total.

Heads upFunding only settles while a Hyperliquid tab stays open. Close every tab over the hour and Papurrr skips the payment for the hour.

Fees

Fill type	Default rate	Applies to
Taker	0.045%	Market orders, IOC, crossing limits, market triggers
Maker	0.015%	Resting limit orders once filled
Liquidation	0%	Liquidation fills

Defaults match Hyperliquid's base volume tier. If your live account sits on a lower tier, set your rates under Settings.

Popup

Click the Papurrr icon while a Hyperliquid tab is active.

Field	Meaning
Account value	Balance plus isolated margin plus unrealized PnL.
All time	Account value minus your starting balance and deposits.
Unrealized	Open PnL across every position at the current mid price.
Realized	Closed PnL before fees.
Fees	Total trading fees paid.
Win rate	Share of closing fills with positive closed PnL.
Paper trading	The switch at the top. On keeps every order in your browser. Off sends orders to your real account, and Papurrr asks you to confirm first. The Hyperliquid tab reloads.
Adjust balance	Type an amount, then click Add, Remove or Set to. The presets set your account value to $1K, $10K, $50K or $100K. Click the account value to jump to the box. Positions, orders and history stay put, and your all-time PnL ignores the change. Remove only takes free margin.
Reset	Wipes positions, orders and history and restarts with the balance you enter.

Settings

Open Settings at the bottom of the popup.

Setting	Default	Use
Unified account mode	Off	Turn on if your Hyperliquid account uses unified margin and the balance in the order form stays at your real number.
Default leverage	20	Leverage for markets you have not set yet.
Taker fee %	0.045	Fee on fills taking liquidity.
Maker fee %	0.015	Fee on resting fills.
Debug logging	Off	Records hooked traffic for the debug report.

Themes

Papurrr recolors the Hyperliquid app. Pick a theme from the popup and the page changes at once, with no reload.

Themes run separately from paper trading. Turn paper trading off with the switch at the top of the popup and keep your theme while you trade with real funds.

Option	What you get
Off	Hyperliquid's own colors, untouched.
Cream	Cream page, black text, black candles, hollow going up and solid going down. Green and red stay for prices, PnL and the order book. Reads like a printed chart.
Custom	Eight colors you pick: panels, gaps, text, muted text, lines, up, down and accent. Plus a switch for hollow up candles.

How the recoloring works

Papurrr reads the colors Hyperliquid defines in its own stylesheet and maps each one onto your palette by brightness and hue. Dark backgrounds become your background, panel colors become your panel color, greens become your up color, reds become your down color. Hyperliquid shipping new colors does not break the mapping.

The chart

Candles are drawn on a canvas, so page styling cannot reach them. Papurrr sends your colors to the chart widget instead. If the chart keeps its original candles while the rest of the page changes, send a debug report and the hook status line tells me whether Papurrr found the widget.

Safety

Papurrr uses two layers so no paper order turns into a real one.

Page hooks. Papurrr wraps the page's network calls, XHR requests and WebSocket connection before Hyperliquid's code loads. Every order, cancel, modify and leverage change gets answered in your browser.
Browser block. While paper mode runs, a Chrome network rule blocks every request from app.hyperliquid.xyz to api.hyperliquid.xyz/exchange. If a hook ever misses a request, the request fails instead of placing a trade.

The pink ON badge on the toolbar icon means paper mode is active. No badge means Hyperliquid runs normally and orders go to your real account.

Before live tradingTurn paper mode off in the popup and wait for the tab to reload. Check the badge is gone before you place a real order.

Troubleshooting

Positions or balance do not update

Open the popup, expand Settings and read Hook status. The list shows which Hyperliquid data feeds Papurrr intercepted. Turn on Debug logging, place a small order, then click Copy debug report and send the report with your bug.

Balance in the order form shows your real number

Turn on Unified account mode and save. The tab reloads.

"Page engine did not respond"

Reload the Hyperliquid tab. This happens when Papurrr was installed or updated while the tab sat open.

Numbers jump between two tabs

Keep one Hyperliquid tab open at a time. Each tab runs its own engine and the last one to save wins.

Referral discount

Hyperliquid takes 4% off trading fees for accounts created through a referral link, and pays the referrer a share of those fees. Papurrr carries a referral code, so creating your account through this link funds the project and cuts your fees.

The discount attaches at account creation only. An account already open cannot add a code later.

The one-time prompt

Papurrr shows a small prompt in the corner of the Hyperliquid page when two things are true: the connected wallet has no referrer, and the wallet has never traded. Close the prompt and Papurrr never shows the prompt again. Papurrr checks this through Hyperliquid's public API and sends nothing anywhere else.

Paper trading works the same whether or not you use the link.

Known limits

Main perp markets only. Spot, TWAP and HIP-3 markets are off in paper mode.
Resting limits fill in full once the mid price touches your price. Papurrr does not model queue position or partial fills on resting orders.
Your paper orders do not move the real book. Large orders get the real book's depth, with no market impact after the fill.
Vaults, staking, transfers and withdrawals are off in paper mode.
Paper data belongs to one browser profile. A second browser starts a new account.

Privacy

Papurrr has no server, no analytics and no account. Read the full privacy policy. Positions, orders, fills and settings live in your browser's local storage for app.hyperliquid.xyz. Papurrr reads public market data from Hyperliquid's API, the same data the Hyperliquid app loads.

Changelog

1.0.0 · Launch

Paper trade every main Hyperliquid perp inside the real interface.
Market, limit, post only, IOC and reduce-only orders filled against the live order book.
Position TP/SL, entry TP/SL, stop and take profit triggers, with chart lines you drag.
Cross and isolated margin, liquidation and hourly funding, all on Hyperliquid's own formulas.
Themes for the whole app, chart included: Cream, or eight colors of your own.
Themes work with paper trading off, so your real trading gets them too.
Popup with stats, balance controls and a labeled paper trading switch.
A browser block on the order endpoint while paper trading runs.
4% off Hyperliquid fees when you create your account through Papurrr.