@usehyppo/cli

Hyppo API wrapper and market data tooling from your terminal.

npm install -g @usehyppo/cli

hyppo login
hyppo whoami
hyppo price ETH
hyppo funding
hyppo wallet 0x...

The CLI is intentionally an authenticated client for the Hyppo API. It does not store wallet private keys, execute trades, or manage exchange sessions locally. Privy owns user authentication, and Hyppo API/data-agg own provider calls and request/response capture.

Commands

| Command | Purpose | | --------------------------- | ---------------------------------------------------------------- | | hyppo login | Start browser login and store the local Privy-backed CLI session | | hyppo login --token <jwt> | Store an existing Privy access token | | hyppo whoami | Verify the current API session | | hyppo logout | Remove the local CLI auth session | | hyppo auth | Show auth subcommands | | hyppo price <asset> | Read the current Hyperliquid market snapshot through Hyppo API | | hyppo funding [asset] | Read Hyperliquid funding rates through Hyppo API | | hyppo wallet <address> | Show wallet positions, open TP/SL orders, and recent trades | | hyppo schemas | Print stable JSON contracts for agent use |

Add --json to any command for structured output.

Configuration

| Variable | Default | Purpose | | ----------------- | ------------------------ | -------------------------------- | | HYPPO_API_URL | https://api.hyppo.sh | API worker base URL | | HYPPO_LOGIN_URL | https://hyppo.sh/auth/ | Browser login page | | HYPPO_HOME | ~/.hyppo | Local CLI auth-session directory |

The CLI stores only auth.json under HYPPO_HOME. Secrets for Dwellir, HyperTracker, Privy, and provider APIs live in deployment/runtime secret stores and are not read directly by this package.

Publishing

The npm package is published as @usehyppo/cli.

First publish, which may require npm 2FA/OTP:

pnpm publish:cli

After the first publish, configure npm trusted publishing for rowanhen/hyppo-mono and workflow filename release.yml, then run the manual Release GitHub Actions workflow.

Architecture

• CLI commands parse input, render output, and call Effect services.
• HyppoApi is the CLI service boundary for authenticated API calls.
• API worker handles Privy authentication and proxies product endpoints.
• data-agg owns provider integrations, request/response storage, and the read-only Hyperliquid provider.

See docs/architecture.md for the current long-term shape.