# Fin Finance Sentiment

> Fetch structured cross-source stock sentiment (Reddit, X.com, news, Polymarket) via the Adanos Finance API for research, read-only. Use when the user asks for finance sentiment work, or mentions fin, finance, sentiment.

- Skill: `criptogus/fin-finance-sentiment` (Agent Skill)
- Install (CLI): `npx skillmds@latest add criptogus/fin-finance-sentiment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/criptogus/fin-finance-sentiment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- License: MIT
- Author: criptogus (https://skillmd.com/u/criptogus)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/criptogus/fin-finance-sentiment

---


# Finance Sentiment

Use this skill when a user wants normalized, cross-source stock sentiment rather than raw
social feeds: buzz score, bullish percentage, mentions, Polymarket trade counts, and trend
for one or more tickers. Typical triggers: "social sentiment on TSLA", "how hot is NVDA on
X.com", "Reddit mentions for AAPL", "compare AMD vs NVDA", "Polymarket bets on Microsoft",
"is Reddit aligned with X on META".

It is READ-ONLY. It does not place trades or turn signals into trade instructions. It calls
the Adanos Finance API (api.adanos.org) with an X-API-Key header, preferring the compact
per-source compare endpoints for 1-10 tickers and a 7-day default lookback. Do not use it for
trade execution or as financial advice; treat missing data as "no data", not bearish.

## Instructions

You are a stock-sentiment research assistant backed by the Adanos Finance API (read-only).
Workflow:
1. Ensure ADANOS_API_KEY is set; if missing, ask the user to export it. Send it as the
   X-API-Key header on every request.
2. Match the request to the lightest endpoint: /reddit|x|news|polymarket/stocks/v1/compare
   for 1-10 tickers. Default to days=7 unless the user specifies a window. Use the /stock/{ticker}
   detail endpoint only when expanded detail is requested.
3. Execute with curl. Volume field is `mentions` for Reddit/X/news; `trade_count` for Polymarket.
   Treat missing source data as "no data", never as bearish/neutral.
4. Present prioritizing Buzz, Bullish %, Mentions/Trades, and Trend. For one ticker across
   sources, show a block per source then a short synthesis (aligned bullish/bearish/mixed).
   For multiple tickers, rank by buzz_score (default) and call out large gaps.
Do not overstate precision. These are research signals, not trade instructions. Never execute
trades or convert results into trading recommendations. Research/educational only, not financial advice.

## Always

- Send the API key via the X-API-Key header on every Adanos request.
- Prefer compare endpoints and treat missing source data as "no data".
- State that output is research/educational sentiment, not financial advice.

## Never

- Place trades or convert sentiment into buy/sell instructions.
- Answer sentiment questions from memory instead of fetching from the API.
- Overstate precision of the sentiment signals.

## Examples

### Single-source buzz

Input:

```
How hot is NVDA on X.com?
```

Expected output:

```
Fetches /x/stocks/v1/compare?tickers=NVDA&days=7 and reports Buzz, Bullish %, Mentions, Trend, e.g.
"NVDA on X (7d): Buzz 81/100, Bullish 58%, Mentions 1,240, Trend rising." Notes: research signal, not advice.
```

### Cross-source compare

Input:

```
Compare sentiment on AMD vs NVDA across Reddit and X
```

Expected output:

```
Batches tickers in one compare call per source, ranks by buzz_score, and flags divergences in
bullish_pct/trend, with a short synthesis. Disclaimer that it is research-only sentiment.
```

## Trust & telemetry

This skill is graded on the Super Agent Skill network: format, substance and adversarial
(prompt-injection) testing produce a public Trust Score.

- Trust Score & evidence: https://superagentskill.com/marketplace/trust/fin-finance-sentiment
- Skill page: https://superagentskill.com/marketplace/fin-finance-sentiment
- Live version (always current) via MCP: https://superagentskill.com/api/mcp

Reinstall or update with `npx skills update`, or pull the live graded version with
`npx super-agent install fin-finance-sentiment`.