Adanos Finance Sentiment CLI for Stocks & Crypto

· Adanos Software

13 min read Original article ↗

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-DDInclusive UTC start date
--to YYYY-MM-DDInclusive UTC end date
--jsonMachine-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 | cryptoOptional positional market; defaults to stocks
--assetLegacy flag form for stocks or crypto
--stylestarter, daytrader, swing, investor
--from YYYY-MM-DDInclusive UTC start date
--to YYYY-MM-DDInclusive UTC end date
--limit NMax results
--top NTop N results to show
--min-buzz XMinimum buzz score filter
--min-volume NMinimum mention volume filter
--min-platforms NMinimum number of platforms with mentions
--min-sentiment XMinimum sentiment score filter
--max-sentiment XMaximum sentiment score filter

Briefing Command

--profilestarter, daytrader, swing, investor, crypto, research, portfolio
--from YYYY-MM-DDInclusive UTC start date
--to YYYY-MM-DDInclusive UTC end date
--limit NMax results per section
--stocks LISTStock tickers separated by spaces or commas
--crypto LISTCrypto symbols separated by spaces or commas
--from-watchlist NAMEUse 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 listList all saved watchlists
watchlist show NAMEShow symbols in a watchlist
watchlist add NAMEAdd symbols to a watchlist
watchlist remove NAMERemove symbols from a watchlist
watchlist delete NAMEDelete an entire watchlist
watchlist report NAMEGenerate a sentiment report for all symbols

Flags

--assetstocks, crypto, or all (for report)
--symbols LISTSymbols separated by spaces or commas
--from YYYY-MM-DDInclusive UTC start date
--to YYYY-MM-DDInclusive 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

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

adanosShow the compact start screen; emit capabilities JSON when piped
adanos shellStart the persistent interactive shell
adanos shell --fullscreenFullscreen terminal mode
/quotaRefresh the shell's monthly request balance on demand

Global Flags

--jsonStructured JSON output; accepted before or after subcommands
--output text|jsonForce a human or machine-readable output mode
--plainPlain text without automatic JSON
--quietJSON-only output for automation
--no-colorDisable ANSI color
--no-inputFail instead of prompting in automation
--versionPrint version and exit

Credential and Config Commands

adanos loginSave a key through the hidden interactive prompt
adanos login --api-key-stdinRead one key line from stdin
adanos login --api-key-file PATHRead a key from a local file
adanos auth list|switch|currentManage named credential profiles
adanos config show|clearInspect or clear non-secret settings

Onboarding Commands

adanos onboardShow onboarding guide
adanos onboard wizardGuided setup wizard (register, verify by email, redeem, save)
adanos onboard registerStart email verification for a new API key
adanos onboard redeemRedeem the one-time token from your email

Credential Storage

credentials.jsonAPI keys and named profiles
config.jsonNon-secret CLI settings
AutomationPrefer --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.