Polyanna CLI

First-party terminal access for Polyanna leaderboards, trader lookup, analytics, and trade-alert inboxes.

Install Polyanna CLI#

Install

/bin/sh -c "$(curl -fsSL https://polyanna.app/install-cli.sh)"

Paste that in a macOS or Linux shell.

First Run#

Check the install

polyanna --helppolyanna login

polyanna login starts browser approval and stores a CLI credential. The credential has the same authenticated API access as your account tier and can be revoked with polyanna logout or from Account > API Keys.

Commands#

The CLI currently covers leaderboard discovery, trader lookup, trader analytics, and trader trade-alert subscriptions with a hosted CLI inbox.

Session#

polyanna loginStart browser login and store a CLI credential.

polyanna logoutRevoke and remove the active CLI credential.

polyanna upgradeInstall the latest CLI release.

Leaderboards#

polyanna leaderboard listList available leaderboard ids.

polyanna leaderboard get <leaderboard-id>Read one leaderboard.

polyanna leaderboard top <tab> --period <period>Read a tab and period leaderboard.

Traders#

polyanna trader search --query <text>Search known leaderboard traders.

polyanna trader get <address>Read a public trader profile.

polyanna trader analytics <address>Read trader analytics.

Trade Alerts#

polyanna alert sub --trader <name-or-address>Subscribe to trader move alerts.

polyanna alert sub --leaderboard <id> --top <n>Subscribe to current top leaderboard traders.

polyanna alert watchPoll and print CLI inbox alerts continuously.

polyanna alert watch --raw --format ndjsonEmit machine-readable alert events.

polyanna alert history --limit <n>Show recent CLI inbox alert history.

polyanna alert offDisable the CLI inbox channel.

Output#

Use global options on any command. Set POLYANNA_FORMAT to make table, json, csv, or ndjson the default format.

--format table|json|csv|ndjsonSelect the output format. table is the default.

--no-colorDisable terminal colors.

--quietOnly print primary result values where supported.

--verbosePrint request diagnostics.

--timeout <duration>Set request timeout, for example 10s.

--versionPrint the CLI version.

Automation#

Pipe-friendly alert stream

polyanna alert watch --raw --format ndjson

Raw alert streams are designed for scripts and downstream tools. The authenticated subscription and alert inbox stay on Polyanna; your automation consumes JSON or NDJSON events and decides what to do next.

Availability#

Smart-Money Signals and Whale Radar are available in the app and API, but they are not exposed through the CLI yet. Use the API Reference for those endpoints.

Errors#

CLI commands print usage and service errors in terminal-friendly form. Add --verbose to request commands when you need diagnostics, and see the API Reference for shared API status codes.