Finance Sentiment CLI for Stocks & Crypto

30 ENDPOINTS ACROSS 5 PLATFORMS

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

4 Sources

Reddit · 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 (24h)

#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 (24h)

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 --days 7

Watchlist Briefing — "core" (7 days)

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 --days 7

Watchlist Report — "core" (7 days)

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 --days 14

AAPL (Apple Inc.) — Cross-Platform Report (14 days)

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 --days 14

Crypto Comparison — BTC vs ETH (14 days)

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 (24h)

#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 (24h)

#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 (24h)

#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 --days 7 --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.

API Access

Get your API key to use the CLI

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.

Interactive shell with natural language input
Market scanner with 4 trading style presets
Daily briefings with 7 customizable profiles
Watchlist management for stocks and crypto
5 platforms, full endpoint catalog, JSON output for agents
Free tier: 250 requests/month
Same key works with CLI, Python SDK and REST API

Request API Access

Fill out the form below. We'll send you a secure link to retrieve your API key.

Check your email

We've sent a link to retrieve your API key. The link expires in 24 hours and can only be used once.

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+

Select Command Category

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

`--days N`	Time period in days (default: 7)
`--json`	Machine-readable JSON output
`--api-key KEY`	Override API key for this call

Examples

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"

Market scanner with trading style presets and daily briefings with customizable profiles.

Scan Command

`--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

Briefing Command

`--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

Examples

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,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
`--days N`	Time period for reports (default: 7)

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 --days 7
adanos watchlist report core --asset stocks --days 14 --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
`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
`--days N`	Time period (default: 1)
`--limit N`	Max results (default: 20)
`--type`	stock, etf, or all (default: all)

Examples

adanos trending --platform reddit-stocks --limit 10
adanos trending --platform x-stocks --dimension sectors --days 7
adanos trending --platform news-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 all

Direct access to the full OpenAPI endpoint catalog. Each endpoint has a unique ID.

Endpoint IDs

`reddit-stocks.*`	trending, trending.sectors, trending.countries, stock, stock.explain, search, compare, market-sentiment, stats, health
`reddit-crypto.*`	trending, token, search, compare, market-sentiment, stats, health
`x-stocks.*`	trending, trending.sectors, trending.countries, stock, search, compare, market-sentiment, stats, health
`news-stocks.*`	trending, trending.sectors, trending.countries, stock, stock.explain, search, compare, market-sentiment, stats, health
`polymarket-stocks.*`	trending, trending.sectors, trending.countries, stock, search, compare, market-sentiment, stats, health

Examples

adanos endpoint list
adanos endpoint list --json
adanos endpoint call reddit-stocks.stock --ticker TSLA --days 7
adanos endpoint call reddit-stocks.market-sentiment --days 1
adanos endpoint call news-stocks.stock --ticker TSLA --days 7
adanos endpoint call news-stocks.market-sentiment --days 1
adanos endpoint call reddit-crypto.token --symbol BTC --days 14
adanos endpoint call reddit-crypto.market-sentiment --days 1
adanos endpoint call x-stocks.trending --days 7 --limit 20
adanos endpoint call x-stocks.market-sentiment --days 1
adanos endpoint call polymarket-stocks.compare --tickers TSLA,NVDA --days 7
adanos endpoint call polymarket-stocks.market-sentiment --days 1
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 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.

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 broader time windows for less-liquid assets (--days 7 or --days 30). Check service health first if results look stale: adanos health --platform all.