@hedge-layer/cli

Command-line interface for Hedge Layer: prediction market intelligence from the terminal.

The canonical CLI guide now lives in the Hedge Layer web app docs: hedgelayer.ai/docs/cli.

Install

npm install -g @hedge-layer/cli

Requires Node.js 22 or later.

Install troubleshooting

• EACCES / "operation was rejected by your operating system" on npm install -g: your npm prefix points at a root-owned directory (e.g. /usr/lib/node_modules) and you don't have sudo. Install into a user-writable prefix instead:

  mkdir -p "$HOME/.npm-global"
  npm config set prefix "$HOME/.npm-global"
  export PATH="$HOME/.npm-global/bin:$PATH"   # add to your shell rc to persist
  npm install -g @hedge-layer/cli

• nvm warns npmrc ... globalconfig and/or prefix setting ... incompatible with nvm: this is harmless shell-init noise from nvm (not from hl) that appears after setting a custom npm prefix as above — the CLI still works. To avoid it entirely under nvm, install without a custom prefix (nvm's per-version bin/ is already user-writable):

  npm config delete prefix
  npm config delete globalconfig
  nvm use --delete-prefix "$(node -v)" --silent
  npm install -g @hedge-layer/cli

  Alternatively, skip the global install and run on demand with npx @hedge-layer/cli <command>.

Quick Start

# 1. Create an API token at https://hedgelayer.ai/account/settings
# 2. Authenticate the CLI
hl auth login

# 3. Generate a Market Brief
hl brief "US China trade war tariffs"

# 4. Or start an interactive research session
hl research

# 5. Preview a directional quote (analysis only; no order is submitted)
hl quote "example-market" --action buy --outcome yes --cash 25

# 6. Save a fresh quote preview with Signal-linked sizing context
hl quote "example-market" --action buy --outcome yes --cash 25 \
  --signal-id <forecast-id> --capital 1000 --save

# 7. Analyze a market probability edge
hl signal analyze "https://polymarket.com/event/example-market"

Commands

Full command documentation is available at hedgelayer.ai/docs/cli.

Directional quote previews are available with hl quote:

hl quote example-market --action buy --outcome yes --cash 25
hl quote example-market --action buy --outcome no --shares 50 --route passive
hl quote example-market --action sell --outcome yes --shares 20 --save
hl --json quote example-market --action buy --outcome yes --cash 25

Quote reads public Polymarket market data and order-book depth, then reports the estimated fill, slippage, fees, cost or proceeds, payout risk, and optional Signal edge. It never signs or submits an order. --cash is BUY-only; SELL quotes require --shares.

Liquidity allocation, wallet management, and trade execution are outside the official hl CLI.

For a broader discovery screen, hl feed ensemble runs several feed lenses (liquid core, active volume, movers, new markets, uncertainty, and LP quality), de-duplicates by slug, and writes a ranked candidate file:

hl feed ensemble --limit 25 --output candidates.json

Signal-agent analysis is available under hl signal:

hl signal analyze "https://polymarket.com/event/example-market"
hl signal analyze "https://polymarket.com/event/example-market" --context "Recent search notes"
hl --json signal analyze "https://polymarket.com/event/example-market" | jq '.result.analysis'

Changelog

See CHANGELOG.md for release history.

License

MIT