Finance Sentiment

Finance Sentiment Skill

Fetches structured stock sentiment from the Adanos Finance API.

This skill is read-only. It is designed for research questions that are easier to answer with normalized sentiment signals than with raw social feeds.

Use it when the user wants:

• cross-source stock sentiment
• Reddit/X.com/news/Polymarket comparisons
• buzz, bullish percentage, mentions, trades, or trend
• a quick answer to "what is the market talking about?"

---

Step 1: Ensure the API Key Is Available

Current environment status:

!`python3 - <<'PY'
import os
print("ADANOS_API_KEY_SET" if os.getenv("ADANOS_API_KEY") else "ADANOS_API_KEY_MISSING")
PY`

If ADANOS_API_KEY_MISSING, ask the user to set:

export ADANOS_API_KEY="sk_live_..."

Use the key via the X-API-Key header on all requests.

Base docs:

https://api.adanos.org/docs

---

Step 2: Identify What the User Needs

Match the request to the lightest endpoint that answers it.

Default lookback:

• use days=7 unless the user asks for another window

Ticker count:

• use compare endpoints for 1..10 tickers

---

Step 3: Execute the Request

Use curl with X-API-Key. Prefer compare endpoints because they are compact and batch-friendly.

Single-source examples

curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=TSLA&days=7" \
  -H "X-API-Key: $ADANOS_API_KEY"

curl -s "https://api.adanos.org/x/stocks/v1/compare?tickers=NVDA&days=7" \
  -H "X-API-Key: $ADANOS_API_KEY"

curl -s "https://api.adanos.org/polymarket/stocks/v1/compare?tickers=MSFT&days=7" \
  -H "X-API-Key: $ADANOS_API_KEY"

Multi-source snapshot for one ticker

curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"
curl -s "https://api.adanos.org/x/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"
curl -s "https://api.adanos.org/news/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"
curl -s "https://api.adanos.org/polymarket/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"

Multi-ticker comparison

curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=AMD,NVDA,META&days=7" \
  -H "X-API-Key: $ADANOS_API_KEY"

Key rules

1. Prefer compare endpoints over stock detail endpoints for quick research. 2. Use only the sources needed to answer the question. 3. For Reddit, X.com, and news, the volume field is mentions. 4. For Polymarket, the activity field is trade_count. 5. Treat missing source data as "no data", not bearish or neutral. 6. Never execute trades or convert the result into trading instructions.

---

Step 4: Present the Results

When reporting a single source, prioritize exactly these fields:

• Buzz
• Bullish %
• Mentions or Trades
• Trend

Example:

TSLA on Reddit, last 7 days
- Buzz: 74.1/100
- Bullish: 31%
- Mentions: 647
- Trend: rising

When reporting multiple sources for one ticker:

• show one block per source
• then add a short synthesis:
• aligned bullish
• aligned bearish
• mixed / diverging

When comparing multiple tickers:

• rank by the metric the user cares about
• default to buzz_score
• call out large gaps in bullish_pct or trend

Do not overstate precision. These are research signals, not trade instructions.

---

Reference Files

• references/api_reference.md - endpoint guide, field meanings, and example workflows

Read the reference file when you need the exact field names, query parameters, or recommended answer patterns.

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

# 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 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:

https://api.adanos.org/docs

Authentication

Send the API key as:

-H "X-API-Key: $ADANOS_API_KEY"

Compare endpoints

Use compare endpoints for quick snapshots and multi-ticker comparisons.

Reddit

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

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

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

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.

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:

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 with positive tone
• high buzz + low bullish = controversial / crowded bearish setup
• low buzz + rising trend = early attention pickup
• large source disagreement = unstable consensus