Open source · MIT · single Go binary

fomo.family in your terminal.

A fast, single-binary CLI for fomo.family data. Leaderboards, wallets, PnL, positions, token flow, theses and live trades, without opening a browser.

Star on GitHub Read the docs
Leaderboards / Wallets / PnL / Live trades Scroll Linux · macOS · Windows

// 00 what it is

Find the traders who are up. Resolve them to their real wallets. Read their positions and their reasoning. Watch every trade land in realtime. All from the command line, with every credit accounted for.

// 01 see it run

The whole market, one keystroke away.

fomocli — zsh

        

Sample data from fomocli --demo. Runs with no API key and no network.

// 02 highlights

Built for traders who live in the terminal.

01

Everything the API offers

Traders, positions, swaps, multi-chain portfolios, following and followers, spotlight, token flow, dev and insider positions, smart-money holders, theses, comment threads and search.

02

Live ticker, zero credits

fomocli live streams the app feed, or the on-chain feed on Growth+, over a WebSocket with auto-reconnect. Streaming costs nothing.

03

Full-screen dashboard

fomocli dash puts the leaderboard, token boards, the live feed and theses in one keyboard-driven TUI.

04

Offline-first

Every response is cached on disk. --offline replays the last data you saw, and a dropped connection falls back to the cache on its own.

05

Credit-aware

Every command shows what it cost and what is left. Expensive calls are labeled right in --help, and cache hits are free.

06

Scriptable

--json on every command with clean stdout, meaningful exit codes, shell completion and FOMO_API_KEY.

// 03 commands

Every view, priced up front.

Cost is in API credits per call. Cached responses cost 0. Full reference in the docs.

// 04 alpha tools

See the swarm before the chart does.

fomocli radar · 0 credits

Swarm radar

An alarm when several traders pile into the same token within minutes, or --side sell for coordinated dumps.

SWARM BUY $STONK solana · 09:20:25

3 traders · 3 buys · $16.3K in 24m

@TEFL0ND0N $10.1K · @EvilPanda $3K

fomocli scan · 750 credits

Rug scanner

One 0 to 100 risk score from buy/sell flow, top-10 concentration, dev and insider exits and smart-money holders, with every reason listed.

0/100 · high risk
fomocli card · 2,750 credits

Share cards

A 1200×675 PNG of a trader's PnL, win rate and best trade, ready for X or Telegram. Send it straight out with --send telegram.

Alerts to your phone

Connect a Telegram bot or a Discord webhook, then add --notify telegram,discord to radar, live, watch or scan.

Example FomoCLI trader card for @CryptoKaleo showing +$151.4K all-time PnL

// 05 offline mode

Your data. Even when the wifi isn't.

  1. 01

    Repeat for free

    A command repeated inside the cache TTL (default 60s) is served from disk for 0 credits. Skip it with --fresh.

  2. 02

    Automatic fallback

    If the network drops, fomocli shows the cached copy and tells you how old it is.

  3. 03

    Explicit offline

    --offline or FOMO_OFFLINE=1 never touches the network. Even live --offline replays recorded events.

offline
fomocli lb --offline                       # last leaderboard you loaded
fomocli t CryptoKaleo positions --offline  # last positions
fomocli live --offline -n 50               # replay 50 live events
fomocli cache ls                           # what's available offline
scripting
# Top 10 by volume as CSV
fomocli lb 7d --json | jq -r '.traders | sort_by(-.volumeUsd)[:10][] | [.handle, .volumeUsd] | @csv'

# Every whale buy on Robinhood Chain
fomocli live --chain robinhood --min-usd 25000 --json | jq -c '{trader, token, usdValue}'

// 06 install

Ten seconds to your first leaderboard.

$ curl -fsSL https://raw.githubusercontent.com/FomoCLI/FomoCLI/main/scripts/install.sh | sh
fomocli --demo lb                 # look around with sample data, no key needed
fomocli auth login                # paste your API key
fomocli lb                        # top traders, 24h
fomocli trader CryptoKaleo        # wallets, PnL by window, stats
fomocli live --chain robinhood    # realtime ticker
fomocli dash                      # full-screen dashboard
Copied to clipboard