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
Current API data
5 Sources
Reddit Stocks · Reddit Crypto · X · News · Polymarket
Install
Up and running in 60 seconds
Install with pipx, Homebrew, the standalone installer or pip. The guided onboarding wizard handles API key setup.
$ pipx install adanos-cli
$ adanos onboard wizard
Welcome! Let's get you set up...
$ adanos shell
adanos [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.
Interactive Shell
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 Market Sentiment CLI
account: free (120/250 left) | api: https://api.adanos.org
Type /help for the full command catalog.
adanos [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 [120 requests left]> /compare TSLA NVDA
Stock compare (7d): TSLA, NVDA
- News:
TSLA: buzz=74.6, mentions=216, sentiment=0.49
NVDA: buzz=70.1, mentions=194, sentiment=0.57
adanos [120 requests left]> /scan crypto
Crypto 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
adanos [120 requests left]> /quota
Monthly API requests: 131/250 used (119 remaining)
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 such as /compare, /scan, /briefing and /quota.
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 rank attention, sentiment and source confirmation for your trading style. Built-in presets cover day trading, swing trading and longer-term research.
$ adanos scan stocks --style daytrader --top 5
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
$ adanos scan crypto --min-buzz 50 --min-volume 100 --top 5
Crypto 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.
$ adanos briefing --profile daytrader
Market 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]
$ adanos briefing --from-watchlist core
Market 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.
$ adanos watchlist add core --asset stocks --symbols MSFT AAPL NVDA
Updated watchlist 'core' (stocks).
$ adanos watchlist add core --asset crypto --symbols BTC ETH
Updated watchlist 'core' (crypto).
$ adanos watchlist show core
core:
stocks: MSFT, AAPL, NVDA
crypto: BTC, ETH
$ adanos watchlist report core --asset all
Watchlist report: core [all] (7d)
Stock compare (7d): MSFT, AAPL, NVDA
Crypto 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.
$ adanos stock AAPL
Stock 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
$ adanos compare NVDA TSLA AAPL
Stock 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
$ adanos crypto BTC/ETH
Crypto 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.
$ adanos trending stocks --limit 5
Trending 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)
$ 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 search Tesla
Search across all market sources: Tesla
- News Stocks: TSLA (Tesla, Inc.)
- Reddit Stocks: TSLA (Tesla, Inc.)
- X/Twitter Stocks: TSLA (Tesla, Inc.)
$ adanos stats
Platform statistics
AI Agent Integration
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.
$ adanos --json capabilities
{"kind":"capabilities","command":"capabilities","name":"adanos-cli","output_modes":["auto","text","json"],...}
$ adanos --json endpoint list
[{"kind":"endpoint_spec","command":"endpoint","subcommand":"list","id":"news-stocks.trending","path":"/news/stocks/v1/trending"},...]
$ 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,...}}
$ adanos --json scan stocks --style daytrader
{"kind":"stock_scan","command":"scan","asset":"stocks","style":"daytrader","rows":[...]}
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 or network error, 2 = usage, authentication or missing configuration error. Errors stay 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
auto, --output text, --json
Credentials
~/.config/adanos-cli/credentials.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 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) |
Flags
--from YYYY-MM-DD | Inclusive UTC start date |
--to YYYY-MM-DD | Inclusive UTC end date |
--json | Machine-readable JSON output |
Examples
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"
Market scanner with trading style presets and daily briefings with customizable profiles.
Scan Command
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 |
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 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 |
Examples
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 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 LIST | Symbols separated by spaces or commas |
--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
Aggregate discovery and analysis across all five platforms by default, with optional source-level overrides.
Commands
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 |
Trending Flags
--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) |
Search Flags
--platform | Optional source override; omitted searches every source |
--limit N | Max results (default: 20) |
Examples
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 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 | 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 |
Global Flags
--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 |
Credential and Config Commands
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 |
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 |
Credential Storage
credentials.json | API keys and named profiles |
config.json | Non-secret CLI settings |
Automation | Prefer --api-key-stdin or --api-key-file |
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
# 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
FAQ
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 (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 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.