35,000+ TICKERS · 5 SOURCES
Command-line tool for stock and crypto sentiment. Scan markets, run watchlists and query Reddit, X, news and Polymarket data from your terminal.
Real-Time
Always fresh data
5 Sources
Reddit Stocks · Reddit Crypto · X · News · Polymarket
Install
Up and running in 60 seconds
Install from PyPI with pip or pipx. The guided onboarding wizard handles API key setup.
$ pip install adanos-cli
$ adanos onboard wizard
Welcome! Let's get you set up...
$ adanos
adanos> How does TSLA look?
TSLA (Tesla, Inc.) — Cross-Platform Report (7 days)
Or just tell Claude & OpenAI: Install adanos-cli from PyPI and run the onboarding wizard to set up my API key.
Python 3.10+
Install from PyPI with pip install adanos-cli or pipx install adanos-cli. Works on macOS, Linux and Windows.
Secure Config
API key stored locally in ~/.config/adanos-cli/config.json. Never sent to third parties.
Onboarding Wizard
Run adanos onboard wizard for guided setup. Registers, retrieves and saves your API key automatically.
Interactive Shell
Just type. The shell understands you.
Run adanos without arguments to start the interactive shell. Plain text is interpreted as a natural language query. Slash commands give direct access to all CLI features.
$ adanos
Welcome to adanos-cli v1.19.1
Type a question or use /commands. /help for options.
adanos> How does TSLA look?
TSLA (Tesla, Inc.) — Cross-Platform Report (7 days)
Reddit: Buzz 87.5 | Bullish 45% | 342 mentions | rising
X/Twitter: Buzz 71.2 | Bullish 52% | 189 mentions | stable
News: Buzz 74.6 | Bullish 49% | 216 mentions | rising
Polymarket: Buzz 63.8 | 12 active markets
adanos> TSLA vs NVDA
TSLA NVDA
Buzz 87.5 72.3
Bull 45% 54%
Ment 342 189
Trend rising stable
adanos> /scan crypto
#1 BTC Buzz 91.2 | Bull 58% | 1,204 mentions | rising
#2 ETH Buzz 78.4 | Bull 51% | 687 mentions | stable
#3 SOL Buzz 65.1 | Bull 62% | 312 mentions | rising
Natural Language
Type questions in English or German. The shell detects tickers, intent and routes to the right endpoints automatically.
Slash Commands
Prefix with / for direct commands: /scan, /briefing, /watchlist, /trending and more.
Fullscreen Mode
Run adanos shell --fullscreen for a dedicated terminal experience. Or set ADANOS_CLI_FULLSCREEN=1.
Practical Examples
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 find opportunities matching your trading style. Built-in presets for day trading, swing trading and long-term investing. Filter by buzz score, volume, sentiment and number of platforms.
$ adanos scan --asset stocks --style daytrader
Daytrader Scan — Stocks (Today)
#1 TSLA Buzz 87.5 | Bull 45% | 342 ment | rising | 4 platforms
#2 NVDA Buzz 72.3 | Bull 54% | 189 ment | stable | 4 platforms
#3 AMD Buzz 68.9 | Bull 61% | 156 ment | rising | 2 platforms
#4 AAPL Buzz 55.1 | Bull 48% | 134 ment | falling | 4 platforms
#5 PLTR Buzz 51.7 | Bull 67% | 98 ment | rising | 2 platforms
$ adanos scan --asset crypto --min-buzz 50 --min-volume 100 --limit 5
Custom Scan — Crypto (min buzz: 50, min volume: 100)
#1 BTC Buzz 91.2 | Bull 58% | 1,204 ment | rising
#2 ETH Buzz 78.4 | Bull 51% | 687 ment | stable
#3 SOL Buzz 65.1 | Bull 62% | 312 ment | rising
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.
$ adanos briefing --profile daytrader
Daytrader Briefing — March 3, 2026
Top Movers (Today)
TSLA Buzz 87.5 rising | NVDA Buzz 72.3 stable
AMD Buzz 68.9 rising | PLTR Buzz 51.7 rising
Sector Heat: Technology +3.2% | Energy -1.8%
Market Mood: 54% bullish across 2,847 mentions
$ adanos briefing --from-watchlist core
Watchlist Briefing — "core" (current window)
MSFT Buzz 62.4 | Bull 58% | stable | 156 mentions
AAPL Buzz 55.1 | Bull 48% | falling | 134 mentions
NVDA Buzz 72.3 | Bull 54% | stable | 189 mentions
BTC Buzz 91.2 | Bull 58% | rising | 1,204 mentions
ETH Buzz 78.4 | Bull 51% | stable | 687 mentions
Watchlist management
Create named watchlists for stocks and crypto. Add or remove symbols, generate reports and feed them into briefings.
$ adanos watchlist add core --asset stocks --symbols MSFT,AAPL,NVDA
Added 3 stocks to watchlist "core": MSFT, AAPL, NVDA
$ adanos watchlist add core --asset crypto --symbols BTC,ETH
Added 2 crypto to watchlist "core": BTC, ETH
$ adanos watchlist show core
Watchlist "core"
Stocks: MSFT, AAPL, NVDA
Crypto: BTC, ETH
$ adanos watchlist report core --asset all
Watchlist Report — "core" (current window)
MSFT Buzz 62.4 | Bull 58% | stable | 156 mentions
AAPL Buzz 55.1 | Bull 48% | falling | 134 mentions
NVDA Buzz 72.3 | Bull 54% | stable | 189 mentions
BTC Buzz 91.2 | Bull 58% | rising | 1,204 mentions
ETH Buzz 78.4 | Bull 51% | stable | 687 mentions
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.
$ adanos stock AAPL
AAPL (Apple Inc.) — Cross-Platform Report (current window)
Reddit: Buzz 55.1 | Bull 48% | 134 mentions | falling
X/Twitter: Buzz 49.3 | Bull 51% | 98 mentions | stable
News: Buzz 58.7 | Bull 53% | 176 mentions | rising
Polymarket: Buzz 41.7 | 6 active markets
AI Summary: Apple mentions declining after earnings beat...
$ adanos ask "TSLA vs NVDA"
TSLA NVDA
Buzz 87.5 72.3
Bull 45% 54%
Ment 342 189
Trend rising stable
$ adanos crypto BTC/ETH
Crypto Comparison — BTC vs ETH (current window)
BTC ETH
Buzz 91.2 78.4
Bull 58% 51%
Ment 1,204 687
Trend rising stable
Trending, compare and search
Discover what's buzzing, compare tickers side by side, or search by company name across any platform.
$ adanos trending --platform reddit-stocks --limit 5
Trending Stocks — Reddit (Today)
#1 TSLA Buzz 87.5 | Bull 45% | 342 mentions | rising
#2 NVDA Buzz 72.3 | Bull 54% | 189 mentions | stable
#3 AMD Buzz 68.9 | Bull 61% | 156 mentions | rising
#4 AAPL Buzz 55.1 | Bull 48% | 134 mentions | falling
#5 PLTR Buzz 51.7 | Bull 67% | 98 mentions | rising
$ adanos trending --platform x-stocks --dimension sectors
Trending 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%
$ adanos trending --platform news-stocks --limit 5
Trending Stocks — News (Today)
#1 TSLA Buzz 74.6 | Bull 49% | 216 mentions | rising
#2 NVDA Buzz 70.1 | Bull 57% | 194 mentions | rising
#3 AAPL Buzz 58.7 | Bull 53% | 176 mentions | stable
$ adanos search --platform reddit-crypto "ethereum"
Search results for "ethereum"
ETH Ethereum 687 mentions
ETHFI Ether.fi 12 mentions
AI Agent Integration
Built for AI agents and automation
Every command supports --output json for deterministic, machine-readable output. Errors go to stderr with structured JSON. Stable exit codes make it easy to integrate.
$ adanos capabilities --output json
{"name":"adanos-cli","version":"1.19.1","platforms":["reddit-stocks","reddit-crypto","x-stocks","news-stocks","polymarket-stocks"],...}
$ adanos endpoint list --output json
[{"id":"news-stocks.trending","method":"GET","path":"/news/stocks/v1/trending"},...]
$ adanos endpoint call news-stocks.stock --ticker TSLA --from 2026-05-01 --to 2026-05-07 --json
{"endpoint":"news-stocks.stock","data":{"ticker":"TSLA","buzz_score":74.6,...}}
$ adanos --output json scan --asset stocks --style daytrader
{"scan":{"style":"daytrader","results":[...]}}
Claude, ChatGPT, Agents
Let AI agents call adanos as a tool. JSON output and stable exit codes make parsing trivial.
Deterministic Output
Exit code 0 = success, 1 = runtime error, 2 = auth error. Errors always on stderr.
Self-Documenting
adanos capabilities and adanos endpoint list let agents discover features at runtime.
Commands Reference
Direct endpoint access
Every OpenAPI endpoint is available via adanos endpoint call. Use adanos endpoint list to inspect the full endpoint catalog.
Platforms
reddit-stocks, reddit-crypto, x-stocks, news-stocks, polymarket-stocks
Output Modes
--output text (default) or --output json
Config
~/.config/adanos-cli/config.json
Python
Requires Python 3.10+
High-level commands that aggregate data from multiple platforms into a single report.
Commands
adanos stock <TICKER> | Cross-platform stock report (Reddit + X + News + Polymarket) |
adanos crypto <SYMBOL> | Reddit crypto sentiment report |
adanos crypto <A/B> | Compare two crypto tokens (e.g. BTC/ETH) |
adanos ask "<query>" | Natural language query (English & German) |
Flags
--from YYYY-MM-DD | Inclusive UTC start date |
--to YYYY-MM-DD | Inclusive UTC end date |
--json | Machine-readable JSON output |
--api-key KEY | Override API key for this call |
Examples
adanos stock TSLA
adanos crypto BTC --json
adanos crypto BTC/ETH --from 2026-05-01 --to 2026-05-07
adanos ask "How does NVDA look?" --json
adanos ask "wie sieht es mit aktie AAPL aus"
Market scanner with trading style presets and daily briefings with customizable profiles.
Scan Command
--asset | stocks or crypto (required) |
--style | starter, daytrader, swing, investor |
--from YYYY-MM-DD | Inclusive UTC start date |
--to YYYY-MM-DD | Inclusive UTC end date |
--limit N | Max results |
--top N | Top N results to show |
--min-buzz X | Minimum buzz score filter |
--min-volume N | Minimum mention volume filter |
--min-platforms N | Minimum number of platforms with mentions |
--min-sentiment X | Minimum sentiment score filter |
--max-sentiment X | Maximum sentiment score filter |
Briefing Command
--profile | starter, daytrader, swing, investor, crypto, research, portfolio |
--from YYYY-MM-DD | Inclusive UTC start date |
--to YYYY-MM-DD | Inclusive UTC end date |
--limit N | Max results per section |
--stocks CSV | Custom stock tickers to include |
--crypto CSV | Custom crypto symbols to include |
--from-watchlist NAME | Use a saved watchlist as input |
Examples
adanos scan --asset stocks --style daytrader
adanos scan --asset crypto --min-buzz 50 --min-volume 100
adanos scan --asset stocks --style investor --from 2026-05-01 --to 2026-05-07 --json
adanos briefing --profile daytrader
adanos briefing --profile crypto
adanos briefing --from-watchlist core --from 2026-05-01 --to 2026-05-07 --json
adanos briefing --profile research --stocks TSLA,NVDA --crypto BTC,ETH
Create and manage named watchlists for stocks and crypto. Generate reports and feed watchlists into briefings.
Subcommands
watchlist list | List all saved watchlists |
watchlist show NAME | Show symbols in a watchlist |
watchlist add NAME | Add symbols to a watchlist |
watchlist remove NAME | Remove symbols from a watchlist |
watchlist delete NAME | Delete an entire watchlist |
watchlist report NAME | Generate a sentiment report for all symbols |
Flags
--asset | stocks, crypto, or all (for report) |
--symbols CSV | Comma-separated symbols to add/remove |
--from YYYY-MM-DD | Inclusive UTC start date |
--to YYYY-MM-DD | Inclusive UTC end date |
Examples
# Build a watchlist
adanos watchlist add core --asset stocks --symbols MSFT,AAPL,NVDA
adanos watchlist add core --asset crypto --symbols BTC,ETH
# Manage
adanos watchlist list
adanos watchlist show core
adanos watchlist remove core --asset stocks --symbols AAPL
# Reports
adanos watchlist report core --asset all --from 2026-05-01 --to 2026-05-07
adanos watchlist report core --asset stocks --json
# Use in briefings
adanos briefing --from-watchlist core
Discovery and analysis commands across all five platforms.
Commands
adanos trending | Top trending tickers/tokens by buzz score |
adanos search <query> | Search by ticker or company name with fixed last-7-day discovery summaries |
adanos compare <A,B,C> | Compare up to 10 assets side by side |
adanos stats | Platform statistics (tickers tracked, mentions, etc.) |
adanos health | API health and data freshness check |
Trending Flags
--platform | reddit-stocks, reddit-crypto, x-stocks, news-stocks, polymarket-stocks |
--dimension | main (default), sectors, countries |
--from YYYY-MM-DD | Inclusive UTC start date |
--to YYYY-MM-DD | Inclusive UTC end date |
--limit N | Max results (default: 20) |
--type | stock, etf, or all (default: all) |
Search Flags
--platform | reddit-stocks, reddit-crypto, x-stocks, news-stocks, polymarket-stocks |
--limit N | Max results (default: 20) |
Examples
adanos trending --platform reddit-stocks --limit 10
adanos trending --platform x-stocks --dimension sectors --from 2026-05-01 --to 2026-05-07
adanos trending --platform news-stocks --dimension sectors --from 2026-05-01 --to 2026-05-07
adanos search --platform reddit-crypto "ethereum"
adanos compare --platform polymarket-stocks TSLA,NVDA,AMD --from 2026-05-01 --to 2026-05-07
adanos stats --platform reddit-stocks --json
adanos health --platform all
Direct access to the full OpenAPI endpoint catalog. Each endpoint has a unique ID, including Professional-only raw mention endpoints.
Endpoint IDs
reddit-stocks.* | trending, trending.sectors, trending.countries, stock, stock.explain, stock.mentions, search, compare, market-sentiment, stats, health |
reddit-crypto.* | trending, token, token.mentions, search, compare, market-sentiment, stats, health |
x-stocks.* | trending, trending.sectors, trending.countries, stock, stock.explain, stock.mentions, search, compare, market-sentiment, stats, health |
news-stocks.* | trending, trending.sectors, trending.countries, stock, stock.explain, stock.mentions, search, compare, market-sentiment, stats, health |
polymarket-stocks.* | trending, trending.sectors, trending.countries, stock, stock.mentions, search, compare, market-sentiment, stats, health |
Period-capable endpoint calls accept --from and --to as inclusive UTC dates. Stats endpoints return compact standardized payloads such as total_mentions, unique_tickers, mentions_today, unique_tickers_today and supported_tickers; Polymarket stats use total_trades, total_markets, open_markets_current, open_tickers_current, traded_markets_today, traded_tickers_today and trades_today.
Examples
adanos endpoint list
adanos endpoint list --json
adanos endpoint call reddit-stocks.stock --ticker TSLA --from 2026-05-01 --to 2026-05-07
adanos endpoint call reddit-stocks.stock.mentions --ticker TSLA --from 2026-05-01 --to 2026-05-07
adanos endpoint call reddit-stocks.market-sentiment --from 2026-05-01 --to 2026-05-07
adanos endpoint call news-stocks.stock --ticker TSLA --from 2026-05-01 --to 2026-05-07
adanos endpoint call news-stocks.stock.mentions --ticker AAPL --from 2026-05-01 --to 2026-05-07
adanos endpoint call news-stocks.market-sentiment --from 2026-05-01 --to 2026-05-07
adanos endpoint call reddit-crypto.token --symbol BTC --from 2026-05-01 --to 2026-05-07
adanos endpoint call reddit-crypto.token.mentions --symbol BTC --from 2026-05-01 --to 2026-05-07
adanos endpoint call reddit-crypto.market-sentiment --from 2026-05-01 --to 2026-05-07
adanos endpoint call x-stocks.trending --from 2026-05-01 --to 2026-05-07 --limit 20
adanos endpoint call x-stocks.stock.mentions --ticker NVDA --from 2026-05-01 --to 2026-05-07
adanos endpoint call x-stocks.market-sentiment --from 2026-05-01 --to 2026-05-07
adanos endpoint call x-stocks.stock.explain --ticker NVDA
adanos endpoint call polymarket-stocks.compare --tickers TSLA,NVDA --from 2026-05-01 --to 2026-05-07
adanos endpoint call polymarket-stocks.stock.mentions --ticker TSLA --from 2026-05-01 --to 2026-05-07
adanos endpoint call polymarket-stocks.market-sentiment --from 2026-05-01 --to 2026-05-07
adanos endpoint call news-stocks.stock.explain --ticker NVDA
adanos endpoint call reddit-stocks.stock.explain --ticker NVDA
Interactive shell, API key management, global flags and onboarding wizard.
Shell
adanos | Start interactive shell (recommended for humans) |
adanos shell | Explicit shell mode |
adanos shell --fullscreen | Fullscreen terminal mode |
Global Flags
--api-key KEY | Override API key for this call |
--base-url URL | Override API base URL |
--output text|json | Output format (recommended before subcommand) |
--version | Print version and exit |
Config Commands
adanos config set | Save API key and optional base URL |
adanos config show | Display current config (key is masked) |
adanos config clear | Delete local config file |
Onboarding Commands
adanos onboard | Show onboarding guide |
adanos onboard wizard | Guided setup wizard (register, verify by email, redeem, save) |
adanos onboard register | Start email verification for a new API key |
adanos onboard redeem | Redeem the one-time token from your email |
Config Resolution Order
1. CLI flags | --api-key, --base-url (highest priority) |
2. Environment | ADANOS_API_KEY, ADANOS_BASE_URL |
3. Config file | ~/.config/adanos-cli/config.json |
Examples
# Guided onboarding wizard
adanos onboard wizard
# Manual onboarding
adanos onboard register --name "Jane Doe" --email "jane@example.com" --purpose "Trading research"
# then redeem the one-time token from the verification email
adanos onboard redeem --token kt_abc123 --save
# Config management
adanos config set --api-key sk_live_xxx
adanos config show
# Shell modes
adanos # interactive shell
adanos shell --fullscreen # fullscreen mode
ADANOS_CLI_FULLSCREEN=1 adanos # env var alternative
# Global flags (recommended before subcommand)
adanos --output json capabilities
adanos --output json ask "How does TSLA look?"
FAQ
Frequently Asked Questions
Common questions about the Finance Sentiment CLI.
What is the interactive shell?
Run adanos without arguments to start a persistent shell session. Type questions in plain text and the shell interprets them as natural language queries. Prefix with / for direct commands like /scan, /briefing, or /watchlist show core. Use /help to see available commands.
What scan styles are available?
The market scanner has four built-in presets: starter (general overview), daytrader (high buzz, short window), swing (multi-day trends) and investor (longer-term patterns). Each preset configures filters like buzz score, volume and sentiment automatically.
How do briefings work?
Daily briefings aggregate trending data, sentiment snapshots and key movers into one report. Choose a profile (daytrader, swing, crypto, research, etc.) or combine with a watchlist via --from-watchlist. You can also pass custom tickers with --stocks and --crypto flags.
Can AI agents use the CLI?
Yes. Every command supports --output json for deterministic machine-readable output. adanos capabilities --output json lets agents discover all features at runtime. Errors are emitted to stderr as structured JSON. Exit codes are stable: 0 success, 1 runtime error, 2 auth error.
What platforms are covered?
Five platforms: Reddit Stocks (50+ subreddits), Reddit Crypto, X/Twitter (FinTwit), 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 Python SDK. Run adanos onboard wizard for guided setup, or store an existing key with adanos config set --api-key sk_live_xxx. The key can also be set via the ADANOS_API_KEY environment variable.
What are the system requirements?
Python 3.10 or higher on macOS, Linux, or Windows. Install with pip install adanos-cli or pipx install adanos-cli. The CLI is available as both adanos and adanos-cli commands after installation. If adanos is not found, use python3 -m 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.