SkillAgentSearch skills...

finance-sentiment

Fetch normalized stock sentiment across Reddit, X.com, financial news, and Polymarket from the Adanos Finance API: buzz score, bullish percentage, mention or trade counts, and trend.

Install / Use

npx skills add himself65/finance-skills --skill finance-sentiment

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

91/100

Supported Platforms

Zed

Our assessment of finance-sentiment

finance-sentiment scores 91/100 on our quality scale, 23rd of 101 Finance & Accounting skills we index (top 23%).

Its SKILL.md is 5.0 KB long, well organised into 10 sections with 9 code examples: a solid amount of guidance for an agent.

With 3,348 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 3 months ago, so finance-sentiment is actively maintained.
  • Our last check on 2026-10-29 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-02. Automated pattern scan on 2026-10-02. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

finance-sentiment compared with similar skills

All 4 of these similar skills score higher than finance-sentiment; compare them before choosing.

SkillScoreStarsUpdatedFormat
finance-sentiment (this skill)by himself65913.3k3mo agoSKILL.md
Agent-Reachby Panniantong100112.3k9d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server
crawl4aiby unclecode10087.4k3d agoMCP Server

Frequently asked questions

How do I install finance-sentiment?
Run npx skills add himself65/finance-skills --skill finance-sentiment. The install tabs above show the steps for each supported agent.
Which AI agents does finance-sentiment work with?
It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
Is finance-sentiment safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is finance-sentiment still maintained?
The repository was last updated about 3 months ago, so finance-sentiment is actively maintained.

name: finance-sentiment description: > Fetch normalized stock sentiment across Reddit, X.com, financial news, and Polymarket from the Adanos Finance API: buzz score, bullish percentage, mention or trade counts, and trend. Use this skill whenever the user asks how much a stock is being discussed or how hot it is on social platforms, how many Reddit mentions or Polymarket bets a company has, whether Reddit, X, and news agree, or wants to compare stock buzz and sentiment across tickers. Read-only: it never places trades or modifies anything.

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

  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.

Related Skills

View on GitHub
GitHub Stars3.3k
CategoryFinance
Updated2mo ago
Forks381

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions