Python 3.10+
Use pipx install adanos-cli on Python 3.10+ or install the standalone build with Homebrew or the release installer.
Command-line tool for stock and crypto sentiment. Scan markets, run watchlists and query Reddit, X, news and Polymarket data from your terminal.
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
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
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)
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.
$ 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
# 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 --fullscreen
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.
# 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
Start your trading day with adanos briefing. Choose a profile that matches your strategy or combine it with your watchlist for a personalized summary.
# 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
Create named watchlists for stocks and crypto. Add or remove symbols, generate reports and feed them into briefings.
# 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
Convenience commands for quick lookups. Stock reports aggregate Reddit, X, News and Polymarket data. Crypto reports use Reddit Crypto endpoints.
AAPL
# 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
Start with aggregate market behavior. Add --platform only when you want to inspect one source.
# 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
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.
# 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":[...]}
adanos as a tool. JSON output and stable exit codes make parsing trivial.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.
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.
auto, --output text, --json~/.config/adanos-cli/credentials.jsonCLIadanos stock / crypto / consensus / explain / askadanos 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 stock <TICKER>adanos crypto <SYMBOL>adanos crypto <A/B>adanos consensus <TICKER>adanos explain <TICKER>adanos ask "<query>"--from YYYY-MM-DD--to YYYY-MM-DD--jsonCLIadanos scan / briefingadanos 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 ETH
stocks | cryptostocks--assetstocks or crypto--stylestarter, daytrader, swing, investor--from YYYY-MM-DD--to YYYY-MM-DD--limit N--top N--min-buzz X--min-volume N--min-platforms N--min-sentiment X--max-sentiment X--profilestarter, daytrader, swing, investor, crypto, research, portfolio--from YYYY-MM-DD--to YYYY-MM-DD--limit N--stocks LIST--crypto LIST--from-watchlist NAMECLIadanos watchlist# 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
watchlist listwatchlist show NAMEwatchlist add NAMEwatchlist remove NAMEwatchlist delete NAMEwatchlist report NAME--assetstocks, crypto or all (for report)--symbols LIST--from YYYY-MM-DD--to YYYY-MM-DDCLIadanos trending / search / compare / stats / healthadanos 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 all
adanos trending [stocks|crypto]adanos search <query>adanos compare <A B C>adanos statsadanos health--platform--dimension--from YYYY-MM-DD--to YYYY-MM-DD--limit N--type--platform--limit NCLIadanos endpoint list / calladanos 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
reddit-stocks.*reddit-crypto.*x-stocks.*news-stocks.*polymarket-stocks.*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.
CLIadanos config / shell / onboard# 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?" --json
adanosadanos shelladanos shell --fullscreen/quota--json--output text|json--plain--quiet--no-color--no-input--versionadanos loginadanos login --api-key-stdinadanos login --api-key-file PATHadanos auth list|switch|currentadanos config show|clearadanos onboardadanos onboard wizardadanos onboard registeradanos onboard redeemcredentials.jsonconfig.jsonAutomation--api-key-stdin or --api-key-fileCommon 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 (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.
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.