Finance-skills finance-sentiment

install

source · Clone the upstream repo

git clone https://github.com/himself65/finance-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/himself65/finance-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/data-providers/skills/finance-sentiment" ~/.claude/skills/himself65-finance-skills-finance-sentiment && rm -rf "$T"

manifest: plugins/data-providers/skills/finance-sentiment/SKILL.md

source content

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`

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.