$npx -y skills add himself65/finance-skills --skill finance-sentimentFetch structured stock sentiment across Reddit, X.com, news, and Polymarket using the Adanos Finance API. Use this skill whenever the user asks how much people are talking about a stock, how hot a ticker is on social platforms, how many Polymarket bets exist for a company, whethe
| 1 | # Finance Sentiment Skill |
| 2 | |
| 3 | Fetches structured stock sentiment from the Adanos Finance API. |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | Use it when the user wants: |
| 8 | - cross-source stock sentiment |
| 9 | - Reddit/X.com/news/Polymarket comparisons |
| 10 | - buzz, bullish percentage, mentions, trades, or trend |
| 11 | - a quick answer to "what is the market talking about?" |
| 12 | |
| 13 | --- |
| 14 | |
| 15 | ## Step 1: Ensure the API Key Is Available |
| 16 | |
| 17 | **Current environment status:** |
| 18 | |
| 19 | ```bash |
| 20 | !`python3 - <<'PY' |
| 21 | import os |
| 22 | print("ADANOS_API_KEY_SET" if os.getenv("ADANOS_API_KEY") else "ADANOS_API_KEY_MISSING") |
| 23 | PY` |
| 24 | ``` |
| 25 | |
| 26 | If `ADANOS_API_KEY_MISSING`, ask the user to set: |
| 27 | |
| 28 | ```bash |
| 29 | export ADANOS_API_KEY="sk_live_..." |
| 30 | ``` |
| 31 | |
| 32 | Use the key via the `X-API-Key` header on all requests. |
| 33 | |
| 34 | Base docs: |
| 35 | |
| 36 | ```text |
| 37 | https://api.adanos.org/docs |
| 38 | ``` |
| 39 | |
| 40 | --- |
| 41 | |
| 42 | ## Step 2: Identify What the User Needs |
| 43 | |
| 44 | Match the request to the lightest endpoint that answers it. |
| 45 | |
| 46 | | User Request | Endpoint Pattern | Notes | |
| 47 | |---|---|---| |
| 48 | | "How much are Reddit users talking about TSLA?" | `/reddit/stocks/v1/compare` | Use `mentions`, `buzz_score`, `bullish_pct`, `trend` | |
| 49 | | "How hot is NVDA on X.com?" | `/x/stocks/v1/compare` | Use `mentions`, `buzz_score`, `bullish_pct`, `trend` | |
| 50 | | "How many Polymarket bets are active on Microsoft?" | `/polymarket/stocks/v1/compare` | Use `trade_count`, `buzz_score`, `bullish_pct`, `trend` | |
| 51 | | "Compare sentiment on AMD vs NVDA" | compare endpoints for the requested sources | Batch tickers in one request | |
| 52 | | "Is Reddit aligned with X on META?" | Reddit compare + X compare | Compare `bullish_pct`, `buzz_score`, `trend` | |
| 53 | | "Give me a full sentiment snapshot for TSLA" | compare endpoints across Reddit, X.com, news, Polymarket | Synthesize cross-source view | |
| 54 | | "Go deeper on one ticker" | `/stock/{ticker}` detail endpoint | Use only when the user asks for expanded detail | |
| 55 | |
| 56 | Default lookback: |
| 57 | - use `days=7` unless the user asks for another window |
| 58 | |
| 59 | Ticker count: |
| 60 | - use compare endpoints for `1..10` tickers |
| 61 | |
| 62 | --- |
| 63 | |
| 64 | ## Step 3: Execute the Request |
| 65 | |
| 66 | Use `curl` with `X-API-Key`. Prefer compare endpoints because they are compact and batch-friendly. |
| 67 | |
| 68 | ### Single-source examples |
| 69 | |
| 70 | ```bash |
| 71 | curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=TSLA&days=7" \ |
| 72 | -H "X-API-Key: $ADANOS_API_KEY" |
| 73 | ``` |
| 74 | |
| 75 | ```bash |
| 76 | curl -s "https://api.adanos.org/x/stocks/v1/compare?tickers=NVDA&days=7" \ |
| 77 | -H "X-API-Key: $ADANOS_API_KEY" |
| 78 | ``` |
| 79 | |
| 80 | ```bash |
| 81 | curl -s "https://api.adanos.org/polymarket/stocks/v1/compare?tickers=MSFT&days=7" \ |
| 82 | -H "X-API-Key: $ADANOS_API_KEY" |
| 83 | ``` |
| 84 | |
| 85 | ### Multi-source snapshot for one ticker |
| 86 | |
| 87 | ```bash |
| 88 | curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY" |
| 89 | curl -s "https://api.adanos.org/x/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY" |
| 90 | curl -s "https://api.adanos.org/news/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY" |
| 91 | curl -s "https://api.adanos.org/polymarket/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY" |
| 92 | ``` |
| 93 | |
| 94 | ### Multi-ticker comparison |
| 95 | |
| 96 | ```bash |
| 97 | curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=AMD,NVDA,META&days=7" \ |
| 98 | -H "X-API-Key: $ADANOS_API_KEY" |
| 99 | ``` |
| 100 | |
| 101 | ### Key rules |
| 102 | |
| 103 | 1. Prefer compare endpoints over stock detail endpoints for quick research. |
| 104 | 2. Use only the sources needed to answer the question. |
| 105 | 3. For Reddit, X.com, and news, the volume field is `mentions`. |
| 106 | 4. For Polymarket, the activity field is `trade_count`. |
| 107 | 5. Treat missing source data as "no data", not bearish or neutral. |
| 108 | 6. Never execute trades or convert the result into trading instructions. |
| 109 | |
| 110 | --- |
| 111 | |
| 112 | ## Step 4: Present the Results |
| 113 | |
| 114 | When reporting a single source, prioritize exactly these fields: |
| 115 | - Buzz |
| 116 | - Bullish % |
| 117 | - Mentions or Trades |
| 118 | - Trend |
| 119 | |
| 120 | Example: |
| 121 | |
| 122 | ```text |
| 123 | TSLA on Reddit, last 7 days |
| 124 | - Buzz: 74.1/100 |
| 125 | - Bullish: 31% |
| 126 | - Mentions: 647 |
| 127 | - Trend: rising |
| 128 | ``` |
| 129 | |
| 130 | When reporting multiple sources for one ticker: |
| 131 | - show one block per source |
| 132 | - then add a short synthesis: |
| 133 | - aligned bullish |
| 134 | - aligned bearish |
| 135 | - mixed / diverging |
| 136 | |
| 137 | When comparing multiple tickers: |
| 138 | - rank by the metric the user car |