Getting Started

What is PerpFarm?

PerpFarm is a perpetual DEX aggregator built for airdrop farming. It connects to 10+ perpetual futures exchanges across EVM, StarkNet, and Solana — letting you trade on all of them from a single wallet and a single interface.

Why Use PerpFarm?

• Multi-DEX Airdrop Farming: Qualify for airdrops on Hyperliquid, Orderly, Paradex, Lighter, Ethereal, Drift, and more — simultaneously
• Unified Wallet: A single trading wallet works across all supported DEXs
• Auto Cross-Chain: Deposit USDC on Arbitrum, trade on StarkNet, Base, Solana — PerpFarm handles all bridging
• Multi-DEX Execution: Place the same trade across multiple exchanges with a single click
• Non-Custodial (v2): Your trading key is derived in your browser and never leaves your device
• Zero Fees: PerpFarm charges nothing extra — you pay only native DEX fees

Quick Start

1. Connect Wallet: Sign in with MetaMask or WalletConnect via SIWE (Sign In With Ethereum)
2. Deposit USDC: Send USDC on Arbitrum to your PerpFarm trading wallet
3. Select Exchanges: Check the boxes next to the DEXs you want to trade on
4. Trade: Set your position size (in USD), leverage, and execute

Connecting Your Wallet

Supported Wallets

PerpFarm uses SIWE (Sign In With Ethereum) for authentication:

• MetaMask — Browser extension or mobile
• WalletConnect — Rainbow, Trust Wallet, Coinbase Wallet, etc.
• Hardware Wallets — Ledger, Trezor (via MetaMask bridge)
• Any EVM Wallet — Rabby, Frame, or anything that supports SIWE

Two-Wallet Architecture

PerpFarm uses two wallets to separate identity from trading:

v2 Key Derivation

The trading key is derived client-side using a deterministic process:

Funding Your Account

Deposit Process

1. Navigate to the Fund page after signing in
2. Copy your PerpFarm trading wallet address
3. Send USDC on Arbitrum to that address
4. Your balance appears within seconds

Auto-Bridging

When you trade on a DEX that lives on another chain, PerpFarm automatically bridges the required amount from your Arbitrum balance:

• Stargate V2 / LayerZero: All EVM cross-chain transfers (Arbitrum → Base, Optimism, Ethereum). Pool-based, instant fills.
• Hyperlane: Arbitrum → StarkNet (for Paradex)
• deBridge: EVM → Solana (for Drift, Pacifica, Backpack)
• Lighter Intent Bridge: Lighter uses its own intent-based deposit flow for non-Ethereum chains

You deposit once on Arbitrum. PerpFarm handles everything else.

HIP-3 Venues & Unified Balance

PerpFarm auto-enables Unified Account mode on Hyperliquid for all users. This means:

• USDC venues (HL main, XYZ, ABCD) share one USDC balance — deposit once, trade on all three
• USDH venues (FLX, VNTL, KM) share one USDH balance — PerpFarm auto-swaps USDC → USDH on deposit
• USDe venues (HYNA) — auto-swap USDC → USDe
• USDT0 venues (CASH) — auto-swap USDC → USDT0

No manual venue transfers needed. All collateral swaps happen on HL's spot market with near-zero slippage.

Gas Automation

DEXs on other chains need native gas tokens. PerpFarm handles this automatically:

• Auto-bridges ~0.001 ETH for gas when moving to a new EVM chain
• Uses Stargate V2 for ETH bridging on EVM chains
• deBridge for SOL on Solana

Minimum Deposits

Trading

Placing Orders

1. Select Exchanges: Check the boxes next to the DEXs you want to trade on (1 or all 10)
2. Choose Order Type: Market (instant) or Limit (set your price)
3. Set Position Size: Enter size in USD — PerpFarm converts to token quantity automatically
4. Set Leverage: Choose leverage (max varies by DEX and asset)
5. Execute: Click Long or Short — trades execute on all selected DEXs simultaneously

Market Orders

Execute immediately at the current best price. Subject to slippage on low-liquidity pairs.

Limit Orders

Sit on the order book until your price is reached. No slippage — you get your price or nothing. Remain open until filled or cancelled.

Order Modification

Modify existing orders without cancelling and replacing manually:

• Hyperliquid: Native atomic modification (single API call)
• Lighter: Native modify_order via SDK
• Ethereal: Atomic replace_order (single transaction)
• Other DEXs: Automatic cancel-and-replace (handled transparently)

You can also drag order lines on the chart to adjust visually.

Position Management

• Unified Dashboard: All positions across all DEXs in one view
• Close Individual: Close a position on one DEX while keeping others open
• Close All: Instantly close all positions across all DEXs
• Partial Close: Reduce position size without fully exiting

USD-to-Token Conversion

You enter position sizes in dollars. PerpFarm handles the conversion:

• Fetches current mark price from each DEX
• Calculates token quantity: size_usd / mark_price
• Applies DEX-specific rounding and precision rules
• Submits the correctly-sized order to each exchange

Supported DEXs

PerpFarm integrates with perpetual DEXs across EVM, StarkNet, Solana, and custom L1/L2 chains.

Live & Tested LIVE

Coming Soon READY

Integration complete, pending activation or funding:

Chart & Trading Interface

Charting

PerpFarm uses Lightweight Charts (TradingView library) with real-time data:

• Candlestick Charts: OHLCV data from Binance (1m, 5m, 15m, 1h, 4h, 1D)
• Moving Averages: MA20 and MA50 overlays
• Real-Time Updates: Binance WebSocket price feed with sub-second latency
• Multi-Timeframe: Switch timeframes without page reload

Position Lines

Open positions appear as horizontal lines on the chart:

• Color-coded: green (long), red (short)
• Live PnL displayed next to each line
• Interactive buttons: Reverse and Close on hover
• Filter by exchange or show all

Draggable Order Lines

Limit orders are draggable — click and drag an order line to change the price. Release to confirm. The order is modified on the DEX automatically via the /api/modify endpoint.

Trade Markers

Every executed trade appears on the chart with buy (green "B") and sell (red "S") markers. Hover for timestamp, size, price, and DEX name.

Wallet Security

PerpFarm v2 uses a fully non-custodial model. Your trading key is derived in your browser and never touches the server.

How It Works

1. Your MetaMask signs a deterministic message (one-time per session)
2. keccak256(signature) becomes your trading private key — derived entirely in your browser
3. The key signs all trades locally — the server only relays pre-signed transactions
4. An AES-256-GCM encrypted backup is stored server-side but cannot be decrypted without your MetaMask

Why This Matters

Compared to custodial trading bots (Banana Gun, Maestro, most aggregators):

• If PerpFarm's server is hacked → your funds are still safe
• PerpFarm operators cannot access your funds
• No government subpoena can force handover of keys we don't have
• Your trading wallet is always recoverable from your MetaMask signature

Whitelist System

Withdrawals are restricted to whitelisted addresses only:

• Add addresses in Settings
• 24-hour activation delay (prevents theft via compromised session)
• Cannot withdraw to non-whitelisted addresses

Daily Limits

Configurable daily withdrawal limits to contain damage if a session is compromised:

• Set max withdrawal per 24 hours
• Increasing the limit takes effect after 24-hour delay

Backup & Recovery

• Encrypted keys backed up to a private GitHub repository
• Automated daily backups + event-driven backups on new signups
• Keys remain AES-256-GCM encrypted in backup — only your MetaMask can decrypt
• Disaster recovery: restore from GitHub if primary database fails

Withdrawing Funds

Two-Step Process

1. Withdraw from DEX → Trading Wallet: Funds return to your PerpFarm trading wallet on Arbitrum
2. Withdraw from Trading Wallet → Your Wallet: Standard ERC-20 transfer

Withdrawal Methods by DEX

Airdrop Farming Strategy

Why Multi-DEX Matters

Most perp DEX airdrops reward:

• Trading Volume: Total USD traded
• Consistency: Regular activity over time (not one-time whales)
• Open Interest: Size of positions held
• Days Active: Number of days with at least one trade

By trading on multiple DEXs simultaneously, you qualify for many airdrops at once and multiply your effective volume.

Consistency Over Size

Airdrop algorithms typically reward consistent activity:

• Better: $50/day for 30 days = $1500 total, 30 active days
• Worse: $1500 in one day = $1500 total, 1 active day

Even $10–50/day across multiple DEXs qualifies you.

Active Points Programs

Referral System

How It Works

PerpFarm uses referral codes on supported DEXs. When you trade, the referral code is automatically applied. A portion of fees is rebated to help fund development.

Active Referrals

Fee Structure

PerpFarm charges no additional fees. You pay only native DEX trading fees:

API Reference

Base URL

https://perpfarm.fun/api/

Authentication

All trading endpoints require JWT authentication via SIWE:

1. Get a nonce: POST /api/auth/nonce
2. Sign the SIWE message with your wallet
3. Verify and receive JWT: POST /api/auth/verify
4. Include Authorization: Bearer <token> in all subsequent requests

Auth Endpoints

Market Data

Account & Balances

Trading

Funding & Deposits

v2 Endpoints

Rate Limits

• Trading: 10 requests/minute
• Data Fetching: 60 requests/minute
• Authentication: 5 requests/minute

FAQ

Is PerpFarm custodial?

No. PerpFarm v2 is fully non-custodial. Your trading key is derived in your browser from a MetaMask signature using keccak256. The server stores only an AES-256-GCM encrypted backup it cannot decrypt. Even if PerpFarm's server is compromised, your funds are safe.

What chains are supported?

Deposit chain: Arbitrum (USDC). Auto-bridged to: Base, StarkNet, Solana, Hyperliquid L1, Converge, Reya L2, zkLink. PerpFarm handles all cross-chain bridging automatically via Stargate V2, Hyperlane, and deBridge.

How many DEXs are supported?

17 DEXs are live: Hyperliquid (main) + 7 HIP-3 venues (XYZ, FLX, VNTL, HYNA, KM, CASH, ABCD), Orderly, Paradex, Lighter, Ostium, Ethereal, Aster, Avantis, Drift, and Pacifica. Additional DEXs (Apex, Reya, Backpack) are code-ready and pending activation.

What is Unified Account mode?

PerpFarm auto-enables Hyperliquid's Unified Account mode for all users. This creates a single shared USDC balance across HL main and all USDC-collateral HIP-3 venues (XYZ, ABCD). Non-USDC venues (FLX, VNTL, KM use USDH; HYNA uses USDe; CASH uses USDT0) each have their own collateral pool. You deposit once and trade across all venues — no manual transfers needed.

Does PerpFarm charge fees?

No additional fees. You pay only native DEX trading fees. PerpFarm uses referral codes on some DEXs to earn rebates that help fund development.

What are the minimum trade sizes?

Varies by DEX: Avantis requires $100 minimum collateral, Paradex/Orderly $10, Hyperliquid has no minimum. Most DEXs are in the $10–50 range.

Can I use PerpFarm for regular trading?

Yes. PerpFarm is a full-featured perp DEX aggregator. Use it for regular trading, consolidating your perp positions, or just managing multiple exchanges from one interface.

What happens if PerpFarm shuts down?

Your trading key is derived from your MetaMask signature — you can always re-derive it. For DEXs where funds are held on-chain (Ostium, Avantis), you can interact with the contracts directly. For others, you can use the DEX's native interface with your trading wallet.

Is my data safe?

Private keys are never stored on the server. The encrypted backup can only be decrypted by your MetaMask. Withdrawals require whitelisted addresses with 24-hour activation delays. All encrypted data is backed up to a private GitHub repository.

Troubleshooting

"Not connected" error

Cause: Wallet disconnected or session expired.
Fix: Click "Connect Wallet" and sign the SIWE message again.

Position not showing after trade

Cause: Some DEXs (Ostium) use subgraph-based position tracking with 1–2 minute indexing delays.
Fix: Wait 2–3 minutes and refresh. Check the block explorer for tx confirmation.

Deposit not credited

Cause: Bridge transactions have variable processing times (Stargate, Hyperlane, deBridge).
Fix: Check the tx on the source chain's explorer. Most bridges take 5–30 minutes. If >1 hour, check the bridge's status page.

Order rejected by DEX

Cause: Insufficient balance, leverage too high, minimum size not met, or market closed.
Fix: Check the error message. Common fixes: increase deposit, reduce leverage, increase position size.

Rate limiting errors

Cause: Trading on many DEXs simultaneously can trigger rate limits on individual exchanges.
Fix: PerpFarm automatically retries failed requests. Slight delays (5–10 seconds) are normal when executing on 10 DEXs at once.

Withdrawal stuck

Cause: DEX withdrawal processing times vary. L1 bridges and L2 bridges can take 10–60 minutes.
Fix: Check the DEX's bridge status page. If >2 hours, it's typically a DEX-side issue.