Agents ready · Real-Time CLI · 50K+ tickers

Finance Sentiment CLI
for Stocks & Crypto

Command-line tool for stock and crypto sentiment. Scan markets, run watchlists and query Reddit, X, news and Polymarket data from your terminal.

Agent session · adanos-cli
Which stocks is retail talking about most right now?
adanos scan stocks --style daytrader --top 5
- TSLA: consensus=87.5, sentiment=0.45, signal=bullish (82), platforms=4, activity=342, N:74.6 R:87.5 X:71.2 P:63.8- NVDA: consensus=72.3, sentiment=0.54, signal=bullish (76), platforms=4, activity=189, N:70.1 R:72.3 X:68.4 P:51.2- AMD: consensus=68.9, sentiment=0.52, signal=bullish (71), platforms=4, activity=156, N:52.4 R:68.9 X:57.8 P:38.6- AAPL: consensus=58.7, sentiment=0.53, signal=neutral (64), platforms=4, activity=176, N:58.7 R:55.1 X:49.3 P:41.7
AgentTSLA leads with a consensus buzz of 87.5 across all four platforms. NVDA and AMD follow at 72.3 and 68.9, both bullish. AAPL trails at 58.7 and reads neutral.
TSLATesla 87.5 Bullish 82
NVDANVIDIA 72.3 Bullish 76
AMDAdvanced Micro Devices 68.9 Bullish 71
AAPLApple 58.7 Neutral 64
How does TSLA look?
adanos ask "How does TSLA look?"
- News Stocks: attention/buzz=74.6, trend=rising, mentions=216, sentiment_score=0.49- Reddit Stocks: attention/buzz=87.5, trend=rising, mentions=342, sentiment_score=0.45- X/Twitter Stocks: attention/buzz=71.2, trend=stable, mentions=189, sentiment_score=0.52- Polymarket Stocks: attention/buzz=63.8, trend=rising, trades=84, sentiment_score=0.51
AgentReddit is loudest on TSLA with a buzz of 87.5. Attention is rising on news, Reddit and Polymarket. Sentiment sits between 0.45 and 0.52 on every source.
News216 mentions 74.6 Rising
Reddit342 mentions 87.5 Rising
X.com189 mentions 71.2 Stable
Polymarket84 trades 63.8 Rising

Up and running in 60 seconds

Install with pipx, Homebrew, the standalone installer or pip. The guided onboarding wizard handles API key setup.

# Recommended: isolated install from PyPI$ pipx install adanos-cli # Guided onboarding wizard (register, verify, save)$ adanos onboard wizardWelcome! Let's get you set up... # Start the interactive shell$ adanos shelladanos [120 requests left]> How does TSLA look?Stock report for TSLA (7d)

Or just tell Claude & OpenAI: Install adanos-cli with pipx and run the onboarding wizard to set up my API key.

Python 3.10+

Use pipx install adanos-cli on Python 3.10+ or install the standalone build with Homebrew or the release installer.

Secure Config

Profiles and API keys stay in ~/.config/adanos-cli/credentials.json; non-secret settings stay in config.json.

Onboarding Wizard

Run adanos onboard wizard for guided registration, email verification and safe local credential storage.

Just type. The shell understands you.

Run adanos shell to start the persistent interactive shell. Running adanos without arguments shows the compact start screen on a terminal and capabilities JSON when piped.

adanos shell
$ adanos shellADANOS  Market Sentiment CLIaccount: free (120/250 left)  |  api: https://api.adanos.comType /help for the full command catalog. # Just type. Plain text is treated as a questionadanos [120 requests left]> How does TSLA look?Stock report for TSLA (7d)- News Stocks: attention/buzz=74.6, trend=rising, mentions=216, sentiment_score=0.49- Reddit Stocks: attention/buzz=87.5, trend=rising, mentions=342, sentiment_score=0.45- X/Twitter Stocks: attention/buzz=71.2, trend=stable, mentions=189, sentiment_score=0.52- Polymarket Stocks: attention/buzz=63.8, trend=rising, trades=84, sentiment_score=0.51
adanos shell
# Direct comparison, no ask prefix neededadanos [120 requests left]> /compare TSLA NVDAStock compare (7d): TSLA, NVDA- News:  TSLA: buzz=74.6, mentions=216, sentiment=0.49  NVDA: buzz=70.1, mentions=194, sentiment=0.57 # Slash commands for direct accessadanos [120 requests left]> /scan cryptoCrypto scan (7d):- BTC: buzz=91.2, mentions=1,204, sentiment=0.58, signal=bullish (81), upvotes=18,420- ETH: buzz=78.4, mentions=687, sentiment=0.51, signal=neutral (64), upvotes=9,140 # Refresh the monthly balance only when you need itadanos [120 requests left]> /quotaMonthly API requests: 131/250 used (119 remaining)
adanos shell
$ adanos shell --fullscreen

From quick lookups to full trading workflows

The CLI covers every workflow: quick questions, deep stock reports, market scanning, daily briefings and portfolio tracking.

Market scanner with trading presets

Use adanos scan to rank attention, sentiment and source confirmation for your trading style. Built-in presets cover day trading, swing trading and longer-term research.

Day tradingSwing tradingLonger-term research
TSLA87.5Bullish 82
NVDA72.3Bullish 76
scan.sh
# Day trader scan: high buzz, short window$ adanos scan stocks --style daytrader --top 5Stock scan (7d):- style: daytrader- TSLA: consensus=87.5, sentiment=0.45, signal=bullish (82), platforms=4, activity=342, N:74.6 R:87.5 X:71.2 P:63.8- NVDA: consensus=72.3, sentiment=0.54, signal=bullish (76), platforms=4, activity=189, N:70.1 R:72.3 X:68.4 P:51.2 # Crypto scan with custom filters$ adanos scan crypto --min-buzz 50 --min-volume 100 --top 5Crypto scan (7d):- BTC: buzz=91.2, mentions=1,204, sentiment=0.58, signal=bullish (81), upvotes=18,420- ETH: buzz=78.4, mentions=687, sentiment=0.51, signal=bullish (73), upvotes=9,870

Daily briefings tailored to your profile

Start your trading day with adanos briefing. Choose a profile that matches your strategy or combine it with your watchlist for a personalized summary.

Market briefingdaytrader · 7d
Playbook · stocks longs
TSLA bullish 82NVDA bullish 76
briefing.sh
# Day trader briefing: what's hot right now$ adanos briefing --profile daytraderMarket briefing (daytrader, 7d) Stock scan (7d):- style: daytrader- TSLA: consensus=87.5, sentiment=0.45, signal=bullish (82), platforms=4, activity=342, N:74.6 R:87.5 X:71.2 P:63.8- NVDA: consensus=72.3, sentiment=0.54, signal=bullish (76), platforms=4, activity=189, N:70.1 R:72.3 X:68.4 P:51.2 Playbook:- stocks longs: TSLA[bullish/82], NVDA[bullish/76] # Briefing for your watchlist$ adanos briefing --from-watchlist coreMarket briefing (starter, 7d) Stock compare (7d): MSFT, AAPL, NVDA- News:  NVDA: buzz=70.1, mentions=194, sentiment=0.57  AAPL: buzz=58.7, mentions=176, sentiment=0.53

Watchlist management

Create named watchlists for stocks and crypto. Add or remove symbols, generate reports and feed them into briefings.

core5 symbols
Stocks
MSFTAAPLNVDA
Crypto
BTCETH
watchlist.sh
# Create a watchlist with stocks and crypto$ adanos watchlist add core --asset stocks --symbols MSFT AAPL NVDAUpdated watchlist 'core' (stocks).$ adanos watchlist add core --asset crypto --symbols BTC ETHUpdated watchlist 'core' (crypto). # View your watchlist$ adanos watchlist show corecore:  stocks: MSFT, AAPL, NVDA  crypto: BTC, ETH # Generate a full watchlist report$ adanos watchlist report core --asset allWatchlist report: core [all] (7d) Stock compare (7d): MSFT, AAPL, NVDACrypto compare (7d): BTC, ETH

One-shot stock and crypto reports

Convenience commands for quick lookups. Stock reports aggregate Reddit, X, News and Polymarket data. Crypto reports use Reddit Crypto endpoints.

AAPLStock report · 7d

News58.7↑
Reddit55.1↓
X49.3→
Polymarket41.7→
reports.sh
# Cross-platform stock report (Reddit + X + News + Polymarket)$ adanos stock AAPLStock report for AAPL (7d)- News Stocks: attention/buzz=58.7, trend=rising, mentions=176, sentiment_score=0.53- Reddit Stocks: attention/buzz=55.1, trend=falling, mentions=134, sentiment_score=0.48- X/Twitter Stocks: attention/buzz=49.3, trend=stable, mentions=98, sentiment_score=0.51- Polymarket Stocks: attention/buzz=41.7, trend=stable, trades=52, sentiment_score=0.49 # Direct multi-asset comparison$ adanos compare NVDA TSLA AAPLStock compare (7d): NVDA, TSLA, AAPL- News:  NVDA: buzz=70.1, mentions=194, sentiment=0.57  TSLA: buzz=74.6, mentions=216, sentiment=0.49  AAPL: buzz=58.7, mentions=176, sentiment=0.53 # Compare two crypto tokens$ adanos crypto BTC/ETHCrypto compare (7d): BTC, ETH- BTC: buzz=91.2, mentions=1,204, sentiment=0.58, upvotes=18,420- ETH: buzz=78.4, mentions=687, sentiment=0.51, upvotes=9,870

Trending, compare and search

Start with aggregate market behavior. Add --platform only when you want to inspect one source.

First on every source
TSLA74.6TSLA87.5TSLA71.2TSLA63.8
discovery.sh
# Top stocks across News, Reddit, X and Polymarket$ adanos trending stocks --limit 5Trending stocks (1d):- News: TSLA(74.6), NVDA(70.1), AAPL(58.7)- Reddit: TSLA(87.5), NVDA(72.3), AMD(68.9)- X/Twitter: TSLA(71.2), NVDA(68.4), AAPL(49.3)- Polymarket: TSLA(63.8), NVDA(51.2), AAPL(41.7) # Trending sectors on X/Twitter$ adanos trending --platform x-stocks --dimension sectorsTrending Sectors: X/Twitter (Today)  #1 Technology     Buzz 78.4 | 34 tickers | Bull 54%  #2 Healthcare     Buzz 52.1 | 18 tickers | Bull 49%  #3 Energy         Buzz 47.3 | 12 tickers | Bear 55% # Search company names across all sources$ adanos search TeslaSearch across all market sources: Tesla- News Stocks: TSLA (Tesla, Inc.)- Reddit Stocks: TSLA (Tesla, Inc.)- X/Twitter Stocks: TSLA (Tesla, Inc.) # Platform statistics default to all five sources$ adanos statsPlatform statistics

Built for AI agents and automation

Use --json or --output json for deterministic machine output. Structured results stay on stdout, errors stay on stderr and non-interactive pipelines get JSON automatically.

agent-integration.sh
# Machine-readable capabilities (for agent discovery)$ adanos --json capabilities{"kind":"capabilities","command":"capabilities","name":"adanos-cli","output_modes":["auto","text","json"],...} # List the full endpoint catalog as JSON$ adanos --json endpoint list[{"kind":"endpoint_spec","command":"endpoint","subcommand":"list","id":"news-stocks.trending","path":"/news/stocks/v1/trending"},...] # Direct endpoint call with JSON output$ adanos --json endpoint call news-stocks.stock --ticker TSLA --from 2026-05-01 --to 2026-05-07{"kind":"endpoint_result","command":"endpoint","subcommand":"call","endpoint":"news-stocks.stock","data":{"ticker":"TSLA","buzz_score":74.6,...}} # Scan and briefing in JSON mode$ adanos --json scan stocks --style daytrader{"kind":"stock_scan","command":"scan","asset":"stocks","style":"daytrader","rows":[...]}
  • Claude, ChatGPT, AgentsLet AI agents call adanos as a tool. JSON output and stable exit codes make parsing trivial.
  • Deterministic OutputExit code 0 = success, 1 = runtime or network error, 2 = usage, authentication or missing configuration error. Errors stay on stderr.
  • Self-Documentingadanos capabilities and adanos endpoint list let agents discover features at runtime.

Direct endpoint access

Every OpenAPI endpoint is available via adanos endpoint call. Use adanos endpoint list to inspect the full endpoint catalog.

Command groups

High-level commands that aggregate data from multiple platforms into a single report.

Market scanner with trading style presets and daily briefings with customizable profiles.

Create and manage named watchlists for stocks and crypto. Generate reports and feed watchlists into briefings.

Aggregate discovery and analysis across all five platforms by default, with optional source-level overrides.

Direct access to the full OpenAPI endpoint catalog. Each endpoint has a unique ID, including Professional-only raw mention endpoints.

Interactive shell, API key management, global flags and onboarding wizard.

Platforms
reddit-stocks, reddit-crypto, x-stocks, news-stocks, polymarket-stocks
Output Modes
auto, --output text, --json
Credentials
~/.config/adanos-cli/credentials.json
Python
Requires Python 3.10+
CLIadanos stock / crypto / consensus / explain / ask
adanos stock TSLA
adanos crypto BTC --json
adanos crypto BTC/ETH --from 2026-05-01 --to 2026-05-07
adanos consensus NVDA
adanos explain NVDA --profile investor
adanos ask "How does NVDA look?" --json
adanos ask "wie sieht es mit aktie AAPL aus"

Frequently asked questions

Common questions about the Finance Sentiment CLI.

What is the interactive shell?

Run adanos shell to start a persistent session. Type questions in plain text or prefix direct commands such as /compare, /scan and /briefing. The prompt keeps the latest monthly request balance visible; run /quota to refresh it.

What scan styles are available?

The market scanner has four built-in presets: starter (general overview), daytrader (high attention, short window), swing (multi-day trends) and investor (longer-term patterns). Activity means mentions for social and news sources and trades for Polymarket.

How do briefings work?

Briefings combine scans, focused comparisons and a compact playbook. Choose a profile, load a watchlist with --from-watchlist or pass space-separated focus lists such as --stocks TSLA NVDA --crypto BTC ETH.

Can AI agents use the CLI?

Yes. adanos --json capabilities exposes commands, output modes and the JSON contract at runtime. Exit codes are stable: 0 success, 1 runtime or network error, 2 usage, authentication or missing configuration error.

What platforms are covered?

Five platforms: Reddit Stocks (60+ subreddits), Reddit Crypto, X/Twitter, News Stocks and Polymarket prediction markets. Stock reports aggregate multiple sources (Reddit + X + News + Polymarket). Crypto reports currently use Reddit Crypto endpoints. If no mentions exist in the selected window, you receive a valid response with no data.

Do I need a separate API key?

No. The CLI uses the same Adanos Market Sentiment API key as the REST API and SDKs. Run adanos onboard wizard for guided setup or store an existing key through the hidden adanos login prompt. Automation should use --api-key-stdin or --api-key-file.

What are the system requirements?

pipx and pip installs require Python 3.10+ on macOS, Linux or Windows. Homebrew and standalone release installers are also available. The installed commands are adanos and adanos-cli.

Tips for reliable results?

Use direct symbols (stock, crypto, compare) when possible for the most stable results. Use explicit --from/--to windows for less-liquid assets or historical checks. Check service health first if results look stale: adanos health --platform all.