AXIS docs
 v1.0.0
Live demo Get help
● Start · No code

First-run walkthrough
from opening the app to a first order.

A plain-language tour, screen by screen. Part one is what every trader sees: create or import a wallet, lock the app, fund it, place a first order. Part two is what you do once as the operator: switch trading on and set your builder fee. No programming needed for either.

01Before you start

  • AXIS runs: in Chrome with flutter run -d chrome (Quick start), on a phone, or on your deployed web address.
  • Paper and a pen for the recovery phrase.
  • For a real first order: some native USDC on Arbitrum One (at least 5 USDC, plus enough for the $10 minimum order value at your leverage) and a little ETH on Arbitrum for the deposit's gas.
  • To practise without real money, use a testnet build instead (how).
Real money, real risk

Perpetual futures use leverage. A position can be liquidated and the whole margin lost. Start with an amount you can afford to lose.

02Trader step 1: create or import a wallet

  1. Open the appA short tour explains that keys stay on the device. Press Next or Skip.
  2. Choose the phrase length12 words (standard) or 24 words (maximum).
  3. Create New WalletThe app shows the recovery phrase. Write every word down, in order, on paper. Do not take a screenshot.
  4. Prove you saved itThe app asks for three of the words in order. Only then is the wallet created.
  5. Or: Import Existing WalletEnter a 12 or 24-word recovery phrase, or switch to Private Key (64 hexadecimal characters). Only do this on your own private device.
AXIS first screen: Your keys. Your orders. Choose 12 or 24 words, Create New Wallet or Import Existing Wallet
First screen · regular web build (the demo opens on the desk instead)
Import Wallet screen with Recovery Phrase and Private Key tabs, a field for the words and Paste from Clipboard
Import Existing Wallet

Web build only: before the wallet is saved, the app asks for a vault passphrase (at least 10 characters, typed twice). It encrypts the recovery phrase in this browser, is asked for again after a reload and before showing the phrase, exporting a backup or moving funds, and cannot be reset: if it is lost, the recovery phrase is the way back. The amber note on the first web screen (above) says so: the phrase is stored encrypted with the vault passphrase and kept when the tab closes, and only the written-down phrase can bring the wallet back if the passphrase is lost (details). The live demo skips this screen: it runs on a sample address with no key and no vault.

03Trader step 2: lock the app

  1. Open Account → App lock
  2. Set an app PINType a PIN and confirm it. From now on AXIS opens with the PIN screen.
  3. Biometric unlockOn phones with Face ID, Touch ID or a fingerprint reader, switch it on here.
  4. Auto-lock timerHow long the app may stay in the background before it asks again. The default is 15 minutes.

The PIN protects the screen. The recovery phrase is still the only way to restore the wallet on another device (what if the device is lost).

Security screen with biometric unlock, lock on background, auto-lock timer, set an app PIN and vault security
Account → App lock · on a desktop browser biometrics are unavailable

04Trader step 3: fund the trading account

  1. Send USDC to your AXIS address on ArbitrumFrom an exchange or another wallet. It must be native USDC on Arbitrum One, not USDC.e and not another network. Also send a little ETH on Arbitrum for gas.
  2. Open Trade → DepositEnter the amount (minimum 5 USDC) and confirm. The app sends the USDC to Hyperliquid's bridge on Arbitrum. Once sent it cannot be cancelled.
  3. Wait for the creditThe app watches the account and says Deposit credited to your trading account. This usually takes about a minute. If it says it is still waiting, check again in a few minutes (if not).

A capture of the deposit sheet is not included in these docs yet; the demo build does not send deposits.

05Trader step 4: the first order

  1. Pick a marketIn Markets, tap a contract such as BTC-PERP.
  2. Read and accept the risk disclosureBefore the first order AXIS shows four points: leverage can lose the whole margin, liquidation prices are estimates, orders are signed on the device, funding accrues on open positions. Press I understand.
  3. Fill the ticketChoose leverage and Cross or Isolated, Market or Limit, Long or Short, then the margin. Below, the ticket shows the order value, estimated entry, the worst price at your slippage, size, estimated liquidation price, margin and estimated fees.
  4. The checksThe ticket refuses an order below $10 in value, a size that rounds to zero, or a market with no live price, and says why. If the operator charges a builder fee, the first order asks the wallet to approve it, naming the rate; declining cancels the order.
  5. Place itThe order is signed on the device and sent to Hyperliquid. Positions and open orders appear under the chart.
Risk disclosure over the trade screen listing leverage, liquidation and self-signing warnings with an I understand button
The risk disclosure before the first order · demo build
Order ticket on a phone: 10x cross, market long, margin, slippage, order value, estimated liquidation price and estimated fees including app fee
The order ticket · demo build, sample balances

06Operator: switch trading on and set your fee

Do this once, after Installation. You need the address of a wallet you control that holds at least 100 USDC of Hyperliquid perps collateral (why).

  1. Try it on your own deviceOpen Account → Operator console. Under Surfaces, switch HYPERLIQUID PERPS on.
  2. Set the builder feeUnder Earning — builder fee: switch BUILDER FEE on, paste your BUILDER ADDRESS and press SET, enter a PERPS FEE between 1 and 100 tenths of a basis point (10 = 0.01 %) and press SET. Wrong values are refused with the reason.
  3. Check the Earnings tabPress RECHECK. It should read BUILDER CODE ATTACHED, and Prerequisites should show your collateral at or above 100 USDC.
  4. Place one small orderApprove the fee when asked. Back on Earnings, ORDERS CARRY THE FEE reads YES.
  5. Publish it for everyoneThe console changed only your device. Press COPY AS JSON at the bottom of the console, put the result in your config.json and upload it to your host (how). From the next start, every user's app uses it.
Operator console builder fee section with the switch on, a sample builder address, perps fee 10 and stock dex fee 10
Earning — builder fee · demo build, sample address

What else you can change without code, and what needs a rebuild: Operator console → What you can change.