US Stocks Analysis - SentiSense

Capability skill for US equities. Don't just pull data: synthesize it. This skill teaches the agent five expert workflows that combine price action, sentiment, insider trading, congressional STOCK Act disclosures, institutional 13F flows, analyst ratings, and AI insights into one-line answers a non-technical user can act on. Read-only API. No trading, no purchases, no write operations, no wallet access.

Base URL: https://app.sentisense.ai Website: https://sentisense.ai Full API reference: https://sentisense.ai/skill.md Authentication: API key via X-SentiSense-API-Key header. Generate keys at Settings > Developer Console.

Use & Disclaimer

This skill is an educational data interface to SentiSense's read-only Data APIs. Output is informational only. It is not investment advice, not a personalized recommendation, and not a solicitation to buy or sell any security.

The user is responsible for their own decisions. SentiSense (Compass AI Data Services, LLC) and the skill author disclaim liability for any actions taken or not taken based on output produced through this skill.

The capability workflows below produce data-grounded synthesis. When framing the result for the user, present it as educational context and analysis (signal convergence, sentiment shifts, position changes), never as a personal buy/sell recommendation.

Use of the SentiSense API is subject to the API Terms of Service and Terms of Service.

Authentication

curl -H "X-SentiSense-API-Key: $SENTISENSE_API_KEY" \
  "https://app.sentisense.ai/api/v1/stocks/price?ticker=AAPL"

All endpoints require an API key. Free tier (1,000 req/month, 15 req/min) covers everyday use. PRO ($15/mo) lifts limits and unlocks full preview-gated history.

Anonymous calls return 401 api_key_required.

Capability Menu

Each capability is a natural-language command the user can give the agent. The agent's job is to recognize the intent, run the API calls in order, and synthesize the result. Specific endpoint reference at the bottom of this file.

Capability 1: "Brief me on $TICKER"

A 5-line composite read on a stock that goes far beyond the quote.

Synthesis pattern:

1. GET /api/v1/stocks/price?ticker={T} to anchor with current price + day change
2. GET /api/v2/metrics/entity/{T}/metric/sentiment?period=7d for the 7-day sentiment trend
3. GET /api/v1/insider/trades/{T}?lookbackDays=90 for recent insider activity
4. GET /api/v1/analyst/{T}/consensus for the analyst price target band
5. GET /api/v1/insights/stock/{T}/latest for the most recent AI insight

Synthesize as: "AAPL $190.20 (+1.2%). Sentiment up 8% over 7d. 3 insider buys in 90d, no sells. Analyst target band $180-$250 (mean $210, 33 analysts, Buy). Latest insight: 'Margin guide raised, services revenue beating consensus.'"

The user gets a Bloomberg-style read in five lines.

Capability 2: "What's the smart money doing this week?"

Cross-reference insider cluster buys + congressional STOCK Act trades + analyst upgrades. Surface tickers where all three converge.

Synthesis pattern:

1. GET /api/v1/insider/cluster-buys?lookbackDays=7 for tickers where multiple insiders bought
2. GET /api/v1/politicians/activity?lookbackDays=7 for recent congressional purchases (filter to PURCHASE)
3. GET /api/v1/analyst/market/activity?days=7&types=UPGRADE for analyst upgrades

Synthesize as: intersect the three ticker lists. Report tickers in 2+ of the three buckets, with a one-liner on each: "NVDA: 4 insiders bought ($2.1M), 1 senator purchased $50k-$100k, 2 analyst upgrades."

This is a screen no free data source produces: convergence is the signal.

Capability 3: "Find divergence stocks"

Stocks where price action and sentiment disagree. A bullish gap (price down, sentiment up) often precedes a recovery; a bearish gap (price up, sentiment down) often precedes a fall.

Synthesis pattern:

1. GET /api/v1/stocks/popular to get the candidate list
2. For each: GET /api/v1/stocks/chart?ticker={T}&timeframe=1M (compute 7-day price change)
3. For each: GET /api/v2/metrics/entity/{T}/metric/sentiment?period=7d (compute 7-day sentiment change)
4. Rank by |priceChange - sentimentChange|; report top 5 each direction

Synthesize as: "Bullish divergence (price down, sentiment up): TSLA -8% / sentiment +12%. Bearish divergence (price up, sentiment down): COIN +14% / sentiment -9%."

Capability 4: "Pre-earnings sentiment check on $TICKER"

Before an earnings report, agents and users want to know: is the smart-money / sentiment positioning bullish or bearish?

Synthesis pattern:

1. GET /api/v1/stocks/{T}/profile to confirm the ticker exists and get next earnings date
2. GET /api/v2/metrics/entity/{T}/metric/sentiment?period=30d for the 30-day trend
3. GET /api/v1/insider/trades/{T}?lookbackDays=60 for 60-day insider activity
4. GET /api/v1/analyst/{T}/estimates for consensus EPS/revenue estimate trend
5. GET /api/v1/analyst/{T}/actions?days=30 for recent analyst rating changes

Synthesize as: "AAPL ER in 5d. Sentiment trending +14% over 30d (bullish). Insiders: 2 sells, 0 buys ($1.2M, neutral-to-bearish). EPS consensus $1.52 (revised up from $1.48). 3 upgrades in 30d. Setup: mixed-bullish."

Capability 5: "Sector rotation today"

Which sectors are in greed, which in fear, and what stocks are driving each.

Synthesis pattern:

1. GET /api/v2/market-mood for composite market mood + sector breakdowns
2. For each sector with weeklyChange > +5 or < -5: GET /api/v1/insights/market and filter insights by that sector
3. Report top 2 movers (positive) and bottom 2 (negative)

Synthesize as: "Market mood 62 (Greed, +4 wk). Greed leaders: Technology 71 (+3.2), Communications 68. Fear: Energy 31 (-6), Utilities 36. Top driver: NVDA insight 'Data-center revenue accelerating.' Top drag: XOM 'Crude inventory builds.'"

Endpoint Reference (compact)

For the full schema, see https://sentisense.ai/skill.md.

Price & profile (Public)

• GET /api/v1/stocks/price?ticker={T}: current price, day change
• GET /api/v1/stocks/prices?tickers=A,B,C: batch
• GET /api/v1/stocks/chart?ticker={T}&timeframe=1M|3M|6M|1Y: OHLCV
• GET /api/v1/stocks/{T}/profile: sector, industry, CEO

Sentiment (Public, requires API key)

• GET /api/v2/metrics/entity/{T}/metric/sentiment?period=7d|30d|90d: time series
• GET /api/v2/market-mood: composite fear/greed (0-100), 5 sub-signals, sector breakdowns

Insider (Public, preview)

• GET /api/v1/insider/cluster-buys?lookbackDays=N: tickers with multiple insider buys
• GET /api/v1/insider/trades/{T}?lookbackDays=N: Form 4 filings for a ticker

Congressional STOCK Act (Public, preview)

• GET /api/v1/politicians/activity?lookbackDays=N: recent trades across all members
• GET /api/v1/politicians/member/{slug}/trades: trades by a specific member

Institutional 13F (Public, preview)

• GET /api/v1/institutional/quarters: call this FIRST to get valid reportDate values
• GET /api/v1/institutional/top-holdings/{T}?reportDate={Q}: top holders

Analyst ratings (Public, preview)

• GET /api/v1/analyst/{T}/consensus: price target band, distribution
• GET /api/v1/analyst/{T}/actions?days=N: recent rating changes
• GET /api/v1/analyst/{T}/estimates: EPS / revenue estimates
• GET /api/v1/analyst/market/activity?days=N&types=UPGRADE,DOWNGRADE: market-wide actions

AI insights (Quota-gated)

• GET /api/v1/insights/stock/{T}/latest: newest AI signal for a ticker
• GET /api/v1/insights/stock/{T}/types: list available insight types (no quota cost)
• GET /api/v1/insights/market: top market-wide signals

Agent Tips

• Always wrap data calls. Most preview-gated endpoints return { isPreview, previewReason, data }. Iterate data, not the wrapper.
• Always fetch quarters first before /institutional/* calls. Never hardcode reportDate.
• Free tier is real. A user without PRO still gets back data (just truncated). Synthesize from what you get; don't refuse the workflow.
• Don't hallucinate endpoints. No options flow, no dark pool, no /congress (it's /politicians).
• Be brief. Users asked for synthesis, not a data dump. Five lines beats fifty.

Tier Summary

PRO at $15/month: https://sentisense.ai/pricing