What You Need to Trade

Trading on HyperDex requires three things: a Stellar wallet, test tokens, and a funded XLM balance for transaction fees.

1. Install Freighter

Freighter is the official Stellar browser wallet and the only wallet HyperDex currently supports. It is a browser extension (Chrome / Brave / Firefox).

• →Download from freighter.app and install the extension
• →Create or import a wallet and set network to Mainnet (Public) (Settings → Network → Mainnet)
• →Keep your seed phrase safe — HyperDex never has access to it

2. Get XLM for Fees

Every Stellar transaction requires a small XLM fee (typically 0.00001 XLM). Buy XLM on an exchange (e.g. Coinbase, Kraken) and withdraw it to your Freighter address on the Stellar network. A few XLM is plenty for fees and trustline reserves.

3. Get USDC / EURC

HyperDex swaps USDC ↔ EURC — both are Circle-issued stablecoins on Stellar. Fund your wallet with either:

• →Buy native Stellar USDC on an exchange that supports it (e.g. Coinbase) and withdraw to your Stellar address
• →Or acquire it on the Stellar DEX via a path payment (XLM → USDC, then USDC → EURC) from a wallet like StellarX or Lobstr
• →Add a trustline for each asset in Freighter before receiving it (0.5 XLM reserve each)

4. Run Services (for local testing)

# Terminal 1 — Backend API + WS hub
cd backend && npm run dev
# → HyperDEX Backend running on port 4000

# Terminal 2 — Maker SDK (provides liquidity)
# after `npm run setup` creates credentials/<name>.cred:
cd maker-sdk && npm run dev <name>
# → set a ghost price when prompted (or --engine=./x.ts for a custom engine)
# → [WS] Connected to HyperDEX backend

# Terminal 3 — Frontend
cd frontend && npm run dev
# → Ready on http://localhost:3000

# Verify all systems are live:
curl http://localhost:4000/health
# → { "status": "ok", "activeMakers": 1, "dbStatus": "connected" }