Skip to content

CLI Command Reference ​

Every command accepts --json where output is structured. Global flags: --env sandbox|live, --api-base <url>, --width <cols>.

Session & account ​

CommandDescription
furlpay login [--device|--email <addr>]Browser device flow (RFC 8628) or headless email OTP
furlpay whoamiActive session, verified email, KYC tier, Safe address
furlpay logoutRevoke the local session cookie
furlpay env sandbox|liveSwitch environment
furlpay balanceToken balances across Arbitrum, Base, Optimism, Ethereum
furlpay dashboardAggregate dashboard view

Payments ​

CommandDescription
furlpay pay '@handle' <amt> [USD|USDC|EUR]A2A transfer — quote-bound, consent-first
furlpay pay --demoOffline reference preview (zero API calls)
furlpay pay --dry-run '@handle' 10 USDReal quote, never executes
furlpay send <amt> <0xaddr> --token USDC --chain arbitrumRaw address transfer
furlpay swap USDT USDC 100Token swap
furlpay bridge 100 --from eth --to arbCross-chain bridge

Hyperliquid & trading ​

CommandDescription
furlpay hyperliquid status|marketsValidator connectivity / tradeable contracts
furlpay hyperliquid trade --symbol BTC --side buy|sell --size <s> --leverage <l> [--limit <px>]Signed perp order (LIVE)
furlpay hyperliquid close BTCReduce-only market close (LIVE)
furlpay market <SYM> [--slippage bps] [--side buy]L2 book, depth bands, OFI, micro-price
furlpay account balance|positions|ordersClearinghouse state
furlpay trading limits --max-single-order <usd> --max-leverage <n>Pre-trade risk caps
furlpay trading kill-switch --symbol <SYM>Emergency stop per symbol
furlpay earn hlp stats|deposit <usd>|withdraw <usd>HLP vault (4-day lockup)
furlpay short mechanisms|signalVenue status / readiness research (read-only)

Binance ​

CommandDescription
furlpay binance balancesSpot balances
furlpay binance ticker <SYM> / depth <SYM> --limit nMarket data
furlpay binance spot buy <SYM> --quote <usd> / sell <SYM> --qty <q>Market orders (agent-trust gated)
furlpay binance open-orders [--symbol <SYM>] / cancel <id> --symbol <SYM>Order management

Stellar, RWAs & escrow ​

CommandDescription
furlpay wallet connect ledger|extension|walletconnect|sep7Custody options
furlpay wallet import --name <n> [--mnemonic]Keystore import (stdin only)
furlpay wallet agent-keygen --name <n> --daily-limit <usd> …Delegated agent policy
furlpay trade limit|market-buy|swap|terminalSDEX/Soroban (SIMULATED in this build)
furlpay order list|inspect|cancel|cancel-allOffer management
furlpay rwa list|inspect|kycTokenized securities catalog (SEP-8 never claimed)
furlpay escrow create|fund|start-delivery|proof|release|dispute|statusETSS local escrow ledger

Oracle & Solana (live read-only) ​

CommandDescription
furlpay oracle price <ASSET>Multi-source USD quote (Coinbase/Kraken/Binance/Jupiter), median + agreement gate — DISAGREEMENT/UNAVAILABLE carry a null price
furlpay oracle sourcesSource inventory: endpoints and covered assets (Pyth gateway shown inactive unless configured)
furlpay solana statusLive cluster status from mainnet RPC (epoch, slot, block height)
furlpay solana balance <addr>Lamport balance via live RPC (base58-validated)
`furlpay solana price <mintalias>`
furlpay solana quote <in> <out> <raw-amount>Indicative Jupiter route — labeled INDICATIVE, nothing in this build can fill it
furlpay mainnet readinessEvery execution prerequisite, PASS/FAIL/BLOCKED/NOT_VERIFIED — exit 1 = not ready
furlpay mainnet statusPer-surface network/mode/status snapshot (read-only)
furlpay mainnet dry-run <SYM> --side --sizeReal risk-engine evaluation of a hypothetical order — never signs, never submits

Verification & diagnostics ​

CommandDescription
furlpay tx verify <hash> --network mainnet|testnetReal Horizon lookup with honest semantics
furlpay faucet --address <G...>Friendbot funding (testnet/futurenet only)
furlpay config validateLocal config structural checks
furlpay doctorInstall/registry/config/connectivity diagnostics
furlpay update [--check]Self-update (npm)
furlpay mcp --wallet <name>Start the STDIO MCP server

x402 & forks ​

CommandDescription
furlpay x402 pay --challenge-header <hdr> --max-cost <usd>HTTP 402 settlement (SIMULATED)
furlpay fork networks|inspect|replay-checkFork registry & replay-risk audit (read-only)
furlpay fork simulate|psbt-inspect|opreturn|taint-planReview-only sweep artifacts

Exit codes: 0 success; 1 failure, refused, or unknown outcome. Machine-readable diagnostics via --output json.

FurlPay CLI is non-custodial software. Every execution surface is labeled live or simulated at runtime.