Interactive terminal for stock and crypto sentiment. Market scanner, daily briefings, watchlists, and natural language queries. Data from Reddit, X, and Polymarket. Built for traders, developers, and AI agents.
Install from PyPI with pip or pipx. The guided onboarding wizard handles API key setup.
Install from PyPI with pip install adanos-cli or pipx install adanos-cli. Works on macOS, Linux, and Windows.
API key stored locally in ~/.config/adanos-cli/config.json. Never sent to third parties.
Run adanos onboard wizard for guided setup. Registers, retrieves, and saves your API key automatically.
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.
Type questions in English or German. The shell detects tickers, intent, and routes to the right endpoints automatically.
Prefix with / for direct commands: /scan, /briefing, /watchlist, /trending, and more.
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 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.
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, and Polymarket data. Crypto reports use Reddit Crypto endpoints.
Discover what's buzzing, compare tickers side by side, or search by company name across any platform.
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.
Let AI agents call adanos as a tool. JSON output and stable exit codes make parsing trivial.
Exit code 0 = success, 1 = runtime error, 2 = auth error. Errors always on stderr.
adanos capabilities and adanos endpoint list let agents discover features at runtime.
The CLI connects to the same Adanos Finance Sentiment API. Register once and use your key across the CLI, Python SDK, and direct HTTP calls.
Fill out the form below. We'll send you a secure link to retrieve your API key.
Every OpenAPI endpoint is available via adanos endpoint call. Use adanos endpoint list to see all 31 endpoints.
--output text (default) or --output json
~/.config/adanos-cli/config.json
adanos stock / crypto / ask
High-level commands that aggregate data from multiple platforms into a single report.
adanos stock <TICKER> | Cross-platform stock report (Reddit + X + 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) |
--days N | Time period in days (default: 7) |
--json | Machine-readable JSON output |
--api-key KEY | Override API key for this call |
adanos stock TSLA --days 14
adanos crypto BTC --days 7 --json
adanos crypto BTC/ETH --days 14
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.
--asset | stocks or crypto (required) |
--style | starter, daytrader, swing, investor |
--days N | Time period in days |
--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 |
--days N | Time period in days |
--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 |
adanos scan --asset stocks --style daytrader
adanos scan --asset crypto --min-buzz 50 --min-volume 100
adanos scan --asset stocks --style investor --days 14 --json
adanos briefing --profile daytrader
adanos briefing --profile crypto --days 3
adanos briefing --from-watchlist core --days 7 --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 CSV | Comma-separated symbols to add/remove |
--days N | Time period for reports (default: 7) |
# 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 --days 7
adanos watchlist report core --asset stocks --days 14 --json
# Use in briefings
adanos briefing --from-watchlist coreadanos trending / search / compare / stats / health
Discovery and analysis commands across all four platforms.
adanos trending | Top trending tickers/tokens by buzz score |
adanos search <query> | Search by ticker or company name |
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 |
--platform | reddit-stocks, reddit-crypto, x-stocks, polymarket-stocks |
--dimension | main (default), sectors, countries |
--days N | Time period (default: 1) |
--limit N | Max results (default: 20) |
--type | stock, etf, or all (default: all) |
adanos trending --platform reddit-stocks --limit 10
adanos trending --platform x-stocks --dimension sectors --days 7
adanos search --platform reddit-crypto "ethereum"
adanos compare --platform polymarket-stocks TSLA,NVDA,AMD --days 7
adanos stats --platform reddit-stocks --json
adanos health --platform alladanos endpoint list / call
Direct access to all 31 OpenAPI endpoints. Each endpoint has a unique ID.
reddit-stocks.* | trending, trending.sectors, trending.countries, stock, stock.explain, search, compare, stats, health |
reddit-crypto.* | trending, token, search, compare, stats, health |
x-stocks.* | trending, trending.sectors, trending.countries, stock, search, compare, stats, health |
polymarket-stocks.* | trending, trending.sectors, trending.countries, stock, search, compare, stats, health |
adanos endpoint list
adanos endpoint list --json
adanos endpoint call reddit-stocks.stock --ticker TSLA --days 7
adanos endpoint call reddit-crypto.token --symbol BTC --days 14
adanos endpoint call x-stocks.trending --days 7 --limit 20
adanos endpoint call polymarket-stocks.compare --tickers TSLA,NVDA --days 7
adanos endpoint call reddit-stocks.stock.explain --ticker NVDAadanos config / shell / onboard
Interactive shell, API key management, global flags, and onboarding wizard.
adanos | Start interactive shell (recommended for humans) |
adanos shell | Explicit shell mode |
adanos shell --fullscreen | Fullscreen terminal mode |
--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 |
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 |
adanos onboard | Show onboarding guide |
adanos onboard wizard | Guided setup wizard (register + redeem + save) |
adanos onboard register | Register for an API key from the CLI |
adanos onboard redeem | Redeem delivery token for your API key |
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 |
# Guided onboarding wizard
adanos onboard wizard
# Manual onboarding
adanos onboard register --name "Jane Doe" --email "jane@example.com" --purpose "Trading research"
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?"Common questions about the Finance Sentiment CLI.
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.
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.
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.
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.
Four platforms: Reddit Stocks (50+ subreddits), Reddit Crypto, X/Twitter (FinTwit), and Polymarket prediction markets. Stock reports aggregate multiple sources (Reddit + X + 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 Finance 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.
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.
Use direct symbols (stock, crypto, compare) when possible for the most stable results. Use broader time windows for less-liquid assets (--days 7 or --days 30). Check service health first if results look stale: adanos health --platform all.
The Finance Sentiment CLI is available on PyPI. Install with pip or pipx and run the onboarding wizard. Pair it with a free API key to get started, or upgrade for higher limits and commercial use.