Finance Sentiment
Pull read-only multi-source stock sentiment (Reddit, X, news, Polymarket) via Adanos for quick ticker research and comparisons.
Overview
finance-sentiment is an agent skill most often used in Idea (also Grow analytics) that fetches read-only multi-platform stock sentiment from the Adanos Finance API for tickers and comparisons.
Install
npx skills add https://github.com/himself65/finance-skills --skill finance-sentimentWhat is this skill?
- Read-only Adanos Finance API pulls across Reddit, X.com, news, and Polymarket
- Per-source metrics: buzz, bullish percentage, mentions or trades, and trend
- Supports single-ticker questions and cross-ticker compares (e.g., AMD vs NVDA)
- Alignment checks such as whether Reddit and X agree on a symbol
- Shell curl workflow with ADANOS_API_KEY—no write/trade actions
- 4 sentiment sources: Reddit, X.com, news, and Polymarket
- 4 metric families per source: buzz, bullish percentage, mentions or trades, and trend
Adoption & trust: 853 installs on skills.sh; 2.7k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need a quick, comparable read on how Reddit, X, news, and Polymarket feel about a ticker without manually checking four feeds.
Who is it for?
Agents answering ticker buzz questions, comparing two symbols, or sanity-checking narrative alignment before deeper fundamental work.
Skip if: Live trading execution, personalized investment advice, or environments where you cannot store ADANOS_API_KEY or run curl with outbound network access.
When should I use this skill?
User asks for social sentiment on a ticker, stock buzz, Polymarket activity, cross-source alignment, or AMD vs NVDA-style comparisons.
What do I get? / Deliverables
You get a normalized sentiment snapshot across four sources with buzz, bullish share, volume, and trends suitable for research notes or content angles.
- Per-ticker sentiment breakdown across Reddit, X, news, and Polymarket
- Optional multi-ticker comparison or Reddit-vs-X alignment summary
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Primary shelf is Idea because triggers are discovery and sentiment questions before committing to a trade, feature, or narrative. It fetches normalized buzz, bullish percentage, mentions/trades, and trends—structured research signals, not portfolio operations.
Where it fits
Before building a fintech dashboard feature, compare AMD vs NVDA cross-source sentiment to validate demand for a sentiment widget.
Answer how many Reddit mentions AAPL has this week to ground a newsletter or video topic.
Check whether X and Reddit trends diverge on META after a campaign to tune messaging.
How it compares
API-backed sentiment aggregation for agents—not a replacement for SEC filings, earnings models, or your broker’s order flow.
Common Questions / FAQ
Who is finance-sentiment for?
Solo builders and traders using Claude Code, Cursor, or Codex who want scripted sentiment research across Reddit, X, news, and Polymarket via Adanos.
When should I use finance-sentiment?
In Idea research when exploring TSLA or NVDA buzz; in Grow when checking whether social heat matches a launch or content thesis; whenever trigger phrases like stock buzz or compare sentiment appear.
Is finance-sentiment safe to install?
It is read-only toward markets data but requires an API key and network—review Security Audits on this page and never commit ADANOS_API_KEY to git.
SKILL.md
READMESKILL.md - Finance Sentiment
# finance-sentiment Structured stock sentiment research using the Adanos Finance API. ## What it does Fetches normalized stock sentiment signals across: - **Reddit** - buzz, bullish percentage, mentions, trend - **X.com** - buzz, bullish percentage, mentions, trend - **News** - buzz, bullish percentage, mentions, trend - **Polymarket** - buzz, bullish percentage, trades, trend This skill is useful when a user wants fast answers such as: - "How much are Reddit users talking about TSLA right now?" - "How hot is NVDA on X.com this week?" - "How many Polymarket bets are active on Microsoft right now?" - "Are Reddit and X aligned on META?" - "Compare social sentiment on AMD vs NVDA" **This skill is read-only.** It only fetches sentiment data for research. ## Triggers - "social sentiment on TSLA" - "stock buzz" - "how hot is X stock on X.com" - "how many Reddit mentions does AAPL have" - "how many Polymarket bets on Microsoft" - "compare sentiment on AMD vs NVDA" - "is Reddit aligned with X on META" ## Prerequisites - `ADANOS_API_KEY` must be set in the environment - `curl` available in the shell ## Platform Works on **all platforms** that support shell commands and outbound HTTP requests. ## Setup ```bash # As a plugin (recommended — installs all skills) npx plugins add himself65/finance-skills --plugin finance-data-providers # Or install just this skill npx skills add himself65/finance-skills --skill finance-sentiment ``` See the [main README](../../../../README.md) for more installation options. ## Reference files - `references/api_reference.md` - endpoint guide, field meanings, and example workflows # Finance Sentiment API Reference This skill uses the Adanos Finance API for read-only stock sentiment research. Base docs: ```text https://api.adanos.org/docs ``` ## Authentication Send the API key as: ```bash -H "X-API-Key: $ADANOS_API_KEY" ``` ## Compare endpoints Use compare endpoints for quick snapshots and multi-ticker comparisons. ### Reddit ```text GET /reddit/stocks/v1/compare?tickers=TSLA,NVDA&days=7 ``` Primary fields: - `ticker` - `buzz_score` - `mentions` - `bullish_pct` - `bearish_pct` - `trend` - `sentiment_score` - `unique_posts` - `subreddit_count` - `total_upvotes` ### X.com ```text GET /x/stocks/v1/compare?tickers=TSLA,NVDA&days=7 ``` Primary fields: - `ticker` - `buzz_score` - `mentions` - `bullish_pct` - `bearish_pct` - `trend` - `sentiment_score` - `unique_tweets` - `total_upvotes` ### News ```text GET /news/stocks/v1/compare?tickers=TSLA,NVDA&days=7 ``` Primary fields: - `ticker` - `buzz_score` - `mentions` - `bullish_pct` - `bearish_pct` - `trend` - `sentiment_score` - `source_count` ### Polymarket ```text GET /polymarket/stocks/v1/compare?tickers=TSLA,NVDA&days=7 ``` Primary fields: - `ticker` - `buzz_score` - `trade_count` - `bullish_pct` - `bearish_pct` - `trend` - `sentiment_score` - `market_count` - `unique_traders` - `total_liquidity` ## Detail endpoints Use stock detail endpoints only when the user explicitly asks for a deeper breakdown. ```text GET /reddit/stocks/v1/stock/{ticker} GET /x/stocks/v1/stock/{ticker} GET /news/stocks/v1/stock/{ticker} GET /polymarket/stocks/v1/stock/{ticker} ``` These can include richer fields such as daily trend history and top mentions / top markets. ## Recommended answer patterns ### Single source Always prioritize these four values: - `Buzz` - `Bullish %` - `Mentions` or `Trades` - `Trend` Example: ```text TSLA on X.com, last 7 days - Buzz: 86.1/100 - Bullish: 56% - Mentions: 2,650 - Trend: falling ``` ### Multi-source for one ticker Use one section per source, then synthesize: - aligned bullish - aligned bearish - mixed / diverging Good synthesis prompts: - Is Reddit aligned with X? - Which source is hottest? - Is prediction market activity more bullish than social chatter? ### Multi-ticker comparison Default ranking: - `buzz_score` descending Useful interpretations: - high buzz + high bullish = strong attention