Finance Sentiment Agent Skill

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.

| User Request | Endpoint Pattern | Notes |

|---|---|---|

| "How much are Reddit users talking about TSLA?" | /reddit/stocks/v1/compare | Use mentions, buzz_score, bullish_pct, trend |

| "How hot is NVDA on X.com?" | /x/stocks/v1/compare | Use mentions, buzz_score, bullish_pct, trend |

| "How many Polymarket bets are active on Microsoft?" | /polymarket/stocks/v1/compare | Use trade_count, buzz_score, bullish_pct, trend |

| "Compare sentiment on AMD vs NVDA" | compare endpoints for the requested sources | Batch tickers in one request |

| "Is Reddit aligned with X on META?" | Reddit compare + X compare | Compare bullish_pct, buzz_score, trend |

| "Give me a full sentiment snapshot for TSLA" | compare endpoints across Reddit, X.com, news, Polymarket | Synthesize cross-source view |

| "Go deeper on one ticker" | /stock/{ticker} detail endpoint | Use only when the user asks for expanded detail |

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

• Prefer compare endpoints over stock detail endpoints for quick research.
• Use only the sources needed to answer the question.
• For Reddit, X.com, and news, the volume field is mentions.
• For Polymarket, the activity field is trade_count.
• Treat missing source data as "no data", not bearish or neutral.
• 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.