Command-line tool for stock and crypto sentiment. Scan markets, run watchlists and query Reddit, X, news and Polymarket data from your terminal.
Install with pipx, Homebrew, the standalone installer or pip. The guided onboarding wizard handles API key setup.
Use pipx install adanos-cli on Python 3.10+, or install the standalone build with Homebrew or the release installer.
Profiles and API keys stay in ~/.config/adanos-cli/credentials.json; non-secret settings stay in config.json.
Run adanos onboard wizard for guided registration, email verification and safe local credential storage.
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.
Type questions in English or German. The shell detects tickers, intent and routes to the right endpoints automatically.
Prefix with / for direct commands such as /compare, /scan, /briefing and /quota.
Run adanos shell --fullscreen for a dedicated terminal experience. Or set ADANOS_CLI_FULLSCREEN=1.
The CLI covers every workflow: quick questions, deep stock reports, market scanning, daily briefings and portfolio tracking.
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.
Start your trading day with adanos briefing. Choose a profile that matches your strategy, or combine it with your watchlist for a personalized summary.
Create named watchlists for stocks and crypto. Add or remove symbols, generate reports and feed them into briefings.
Convenience commands for quick lookups. Stock reports aggregate Reddit, X, News and Polymarket data. Crypto reports use Reddit Crypto endpoints.
Start with aggregate market behavior. Add --platform only when you want to inspect one source.
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.
Let AI agents call adanos as a tool. JSON output and stable exit codes make parsing trivial.
Exit code 0 = success, 1 = runtime or network error, 2 = usage, authentication or missing configuration error. Errors stay on stderr.
adanos capabilities and adanos endpoint list let agents discover features at runtime.
Every OpenAPI endpoint is available via adanos endpoint call. Use adanos endpoint list to inspect the full endpoint catalog.
auto, --output text, --json
~/.config/adanos-cli/credentials.json
adanos stock / crypto / consensus / explain / ask
High-level commands that aggregate data from multiple platforms into a single report.
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 consensus <TICKER> | Cross-source consensus, signal and data confidence |
adanos explain <TICKER> | Trader-oriented explanation for a selected profile |
adanos ask "<query>" | Natural language query (English & German) |
--from YYYY-MM-DD | Inclusive UTC start date |
--to YYYY-MM-DD | Inclusive UTC end date |
--json | Machine-readable JSON output |
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"adanos scan / briefing
Market scanner with trading style presets and daily briefings with customizable profiles.
stocks | crypto | Optional positional market; defaults to stocks |
--asset | Legacy flag form for stocks or crypto |
--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 |
--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 LIST | Stock tickers separated by spaces or commas |
--crypto LIST | Crypto symbols separated by spaces or commas |
--from-watchlist NAME | Use a saved watchlist as input |
adanos scan stocks --style daytrader
adanos scan crypto --min-buzz 50 --min-volume 100
adanos scan 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 ETHadanos watchlist
Create and manage named watchlists for stocks and crypto. Generate reports and feed watchlists into briefings.
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 |
--asset | stocks, crypto, or all (for report) |
--symbols LIST | Symbols separated by spaces or commas |
--from YYYY-MM-DD | Inclusive UTC start date |
--to YYYY-MM-DD | Inclusive UTC end date |
# 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 coreadanos trending / search / compare / stats / health
Aggregate discovery and analysis across all five platforms by default, with optional source-level overrides.
adanos trending [stocks|crypto] | Aggregate trending assets; defaults to stocks |
adanos search <query> | Search company names and symbols across API-managed recent summaries |
adanos compare <A B C> | Compare 2–10 assets across relevant sources |
adanos stats | Statistics for all five platforms by default |
adanos health | API health and data freshness check |
--platform | Optional source override: reddit-stocks, reddit-crypto, x-stocks, news-stocks, polymarket-stocks |
--dimension | main (default), stocks, tokens, 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) |
--platform | Optional source override; omitted searches every source |
--limit N | Max results (default: 20) |
adanos trending stocks --limit 5
adanos trending crypto --limit 10
adanos search Tesla
adanos compare NVDA TSLA AAPL
adanos stats
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 TSLA NVDA AMD --platform polymarket-stocks --from 2026-05-01 --to 2026-05-07
adanos stats --platform reddit-stocks --json
adanos health --platform alladanos endpoint list / call
Direct access to the full OpenAPI endpoint catalog. Each endpoint has a unique ID, including Professional-only raw mention endpoints.
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.
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 NVDAadanos config / shell / onboard
Interactive shell, API key management, global flags and onboarding wizard.
adanos | Show the compact start screen; emit capabilities JSON when piped |
adanos shell | Start the persistent interactive shell |
adanos shell --fullscreen | Fullscreen terminal mode |
/quota | Refresh the shell's monthly request balance on demand |
--json | Structured JSON output; accepted before or after subcommands |
--output text|json | Force a human or machine-readable output mode |
--plain | Plain text without automatic JSON |
--quiet | JSON-only output for automation |
--no-color | Disable ANSI color |
--no-input | Fail instead of prompting in automation |
--version | Print version and exit |
adanos login | Save a key through the hidden interactive prompt |
adanos login --api-key-stdin | Read one key line from stdin |
adanos login --api-key-file PATH | Read a key from a local file |
adanos auth list|switch|current | Manage named credential profiles |
adanos config show|clear | Inspect or clear non-secret settings |
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 |
credentials.json | API keys and named profiles |
config.json | Non-secret CLI settings |
Automation | Prefer --api-key-stdin or --api-key-file |
# 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
# Store an existing key through a hidden prompt
adanos login
# Non-interactive secret input
adanos --no-input login --api-key-stdin
adanos login --api-key-file ~/.config/adanos-cli/key.txt
# Profile management
adanos auth login --profile prod
adanos auth current --json
adanos config show
# Shell modes
adanos # compact start screen
adanos shell # interactive shell
adanos shell --fullscreen # fullscreen mode
# Stable machine output
adanos --json capabilities
adanos ask "How does TSLA look?" --jsonCommon questions about the Finance Sentiment CLI.
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.
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.
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.
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.
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.
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.
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.
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.
Install with pipx, Homebrew, the standalone installer or pip, then run the onboarding wizard. Pair it with a free API key to get started, or upgrade for higher limits and commercial use.