Sentisense

SentiSense API - Skill File for AI Agents

> SentiSense is a read-only financial intelligence API: stock prices, insider/politician trading, institutional flows, AI insights, and news sentiment. No trading, no purchases, no write operations. Free tier available.

Base URL: https://app.sentisense.ai Website: https://sentisense.ai ClaWHub Skill: clawhub.ai/TheSentiTrader/sentisense API Docs: https://sentisense.ai/docs/api/ Authentication: API key via X-SentiSense-API-Key header. Generate keys at Settings > Developer Console. SDKs (optional): Python | Node.js -- source on GitHub. As an AI agent, you're encouraged to call the REST API directly with curl/fetch rather than installing packages.

Use & Disclaimer

This skill is an educational data interface to SentiSense's read-only Data API. 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. Use of the API and this skill is subject to the API Terms of Service and Terms of Service.

Authentication

# Include API key in header
curl -H "X-SentiSense-API-Key: ss_live_YOUR_KEY" \
  "https://app.sentisense.ai/api/v1/..."

from sentisense import SentiSenseClient
client = SentiSenseClient(api_key="ss_live_YOUR_KEY")

All API endpoints require an API key. Generate one for free at Settings > Developer Console.

Access Tiers

| Badge | Meaning | |-------|---------| | Public | Available on all tiers (Free and PRO) | | Public (preview) | Free gets limited preview; PRO gets full data | | Quota-gated | Consumes monthly quota (Free: limited, PRO: unlimited) | | Discovery (no quota cost) | API key required (identity/abuse tracking), but the call does not burn your monthly quota. Rate-limit-per-minute still applies. Used for lightweight metadata endpoints like /stocks/with-kpis and /stocks/{ticker}/kpis/types. | | PRO only | Requires PRO subscription |

Rate Limits

| Tier | Requests/Month | Rate | |------|----------------|------| | Free | 1,000 | 15 requests/minute | | PRO ($15/mo) | 100,000 | 120 requests/minute |

What You Can Build

Smart Money Tracker

Sentiment-Driven Watchlist

Congressional Trade Monitor

AI Research Assistant

Market Dashboard

Agent Tips

Workflow Pattern

Common Mistakes

Endpoints That Do NOT Exist

Stocks API (/api/v1/stocks)

GET /api/v1/stocks/price

| Param | Type | Required | Description | |-------|------|----------|-------------| | ticker | string | Yes | Stock ticker (e.g., AAPL) |

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

Response: { ticker, currentPrice, change, changePercent, previousClose, volume, timestamp }

GET /api/v1/stocks/prices

| Param | Type | Required | Description | |-------|------|----------|-------------| | tickers | string | Yes | Comma-separated (e.g., AAPL,TSLA,NVDA) |

GET /api/v1/stocks/chart

| Param | Type | Required | Description | |-------|------|----------|-------------| | ticker | string | Yes | Stock ticker | | timeframe | string | No | 1M, 3M, 6M, 1Y (default: 1M) | | range | string | No | Alias: 5d, 1mo, 3mo, 6mo, 1y (alternative to timeframe) |

GET /api/v1/stocks

GET /api/v1/stocks/detailed

GET /api/v1/stocks/popular

GET /api/v1/stocks/images

| Param | Type | Required | Description | |-------|------|----------|-------------| | tickers | string | Yes | Comma-separated tickers (max 600) |

GET /api/v1/stocks/descriptions

| Param | Type | Required | Description | |-------|------|----------|-------------| | tickers | string | Yes | Comma-separated tickers |

GET /api/v1/stocks/{ticker}/profile

GET /api/v1/stocks/{ticker}/similar

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | limit | int | No | 5 | Max results |

GET /api/v1/stocks/{ticker}/entities

GET /api/v1/stocks/{ticker}/ai-summary

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | depth | string | No | basic | basic or deep | | forceRefresh | boolean | No | false | Generate fresh report |

GET /api/v1/stocks/{ticker}/metrics/{metricType}/breakdown

| Param | Type | Required | Description | |-------|------|----------|-------------| | metricType | path | Yes | sentiment or mentions | | startTime | long | Yes | Start time in epoch ms | | endTime | long | Yes | End time in epoch ms |

GET /api/v1/stocks/market-status

Response: { status: "open" | "closed", timestamp: }. The timestamp is a numeric epoch milliseconds value (not a string).

GET /api/v1/stocks/fundamentals

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | ticker | string | Yes | - | Stock ticker | | timeframe | string | No | quarterly | quarterly or annual | | fiscalPeriod | string | No | - | e.g., Q4 | | fiscalYear | int | No | - | e.g., 2024 |

GET /api/v1/stocks/fundamentals/current

GET /api/v1/stocks/fundamentals/periods

GET /api/v1/stocks/fundamentals/historical/ratios

GET /api/v1/stocks/fundamentals/historical/revenue

GET /api/v1/stocks/short-interest

GET /api/v1/stocks/float

GET /api/v1/stocks/short-volume

GET /api/v1/stocks/{ticker}/quote

Response: { ticker, currentPrice, change, changePercent, volume, open, dayHigh, dayLow, previousClose, week52High, week52Low, marketCap, peRatio, epsTTM, dividendYield, timestamp, extendedHours } -- all fields except ticker are nullable. Cached 15 s server-side.

GET /api/v1/stocks/{ticker}/kpis

Coverage today: near-complete for the S&P 500 plus extended universe (~500 tickers). Use GET /api/v1/stocks/with-kpis to enumerate.

Response wrapper: { isPreview, previewReason, data: CompanyKpis }.

CompanyKpis shape: { ticker, companyName, cik, lastUpdated, kpis: KpiSeries[] }.

KpiSeries shape: { id, name, category, unit, displayFormat, chartType, values: KpiDataPoint[], sourceRef, discontinued, discontinuedNote }. id is a stable per-ticker identifier (e.g. iphone_revenue). category is one of product_revenue, segment_revenue, unit_economics, etc. chartType is bar or line.

KpiDataPoint shape: { period, date, value, isEstimate }. period is the fiscal label (e.g. Q2 FY2026); date is the ISO close date.

GET /api/v1/stocks/with-kpis

Response: { count, tickers: KpiCoverageEntry[] } where each entry is { ticker, companyName, lastUpdated, kpiCount }.

client = SentiSenseClient(api_key="ss_live_YOUR_KEY")
coverage = client.list_kpi_coverage()
print(f"{coverage.count} tickers covered")
for entry in coverage.tickers[:5]:
    print(f"  {entry.ticker}: {entry.kpiCount} KPIs (refreshed {entry.lastUpdated})")

GET /api/v1/stocks/{ticker}/kpis/types

Response: bare array of { id, name, category, chartType }. Returns 404 if the ticker has no curated KPIs.

types = client.get_kpi_types("AAPL")
for t in types:
    print(f"  {t.id} ({t.chartType}): {t.name}")

Metrics API (/api/v2/metrics)

Time series metrics for stocks and entities: mentions, sentiment, social dominance, and more. Computed from serving data with proper entity resolution (tickers are resolved to KB entities automatically).

GET /api/v2/metrics/entity/{entityId}/metric/{metricType}

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | entityId | path | Yes | - | Stock ticker (e.g., AAPL) or KB entity ID | | metricType | path | Yes | - | mentions, sentiment, sentisense, social_dominance | | startTime | long | No | 7 days ago | Epoch milliseconds | | endTime | long | No | now | Epoch milliseconds | | maxDataPoints | int | No | - | Downsample to N data points |

GET /api/v2/metrics/entity/{entityId}/distribution/{metricType}

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | entityId | path | Yes | - | Stock ticker or KB entity ID | | metricType | path | Yes | - | Metric type key | | dimension | string | Yes | - | Dimension to slice by (e.g., source) | | startTime | long | No | 7 days ago | Epoch milliseconds | | endTime | long | No | now | Epoch milliseconds |

GET /api/v2/metrics/entity/{entityId}/metric/{metricType}/slices

GET /api/v2/metrics/entity/{entityId}/baselines/{metricType}

Market Mood API (/api/v2/market-mood)

SentiSense's proprietary composite market sentiment index. Combines social sentiment, market direction, fear gauge, social momentum, and S&P 500 trend signals into a single 0-100 score with sector breakdown. Free (API key required). Free for all tiers, but anonymous calls return 401 api_key_required.

GET /api/v2/market-mood

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | days | int | No | 180 | Days of history to return |

Response shape:

{
  "market": {
    "currentScore": 62.88,
    "phase": "Optimism",
    "weeklyChange": -2.3,
    "signals": [
      {"key": "social_sentiment", "label": "Social Sentiment", "value": 54.95, "change": -1.2},
      {"key": "market_direction", "label": "Market Direction", "value": 71.0, "change": 3.1},
      {"key": "fear_gauge", "label": "Fear Gauge", "value": 58.4, "change": null},
      {"key": "social_momentum", "label": "Social Momentum", "value": 62.1, "change": -0.5},
      {"key": "spy_trend", "label": "S&P 500 Trend", "value": 68.9, "change": 2.0}
    ],
    "history": [
      {"date": "2026-04-01", "timestamp": 1743465600000, "score": 65.2,
       "socialSentiment": 56.1, "marketDirection": 72.0, "fearGauge": 61.0,
       "socialMomentum": 63.5, "spyTrend": 70.0}
    ]
  },
  "sectors": {
    "Technology": {"currentScore": 71.2, "phase": "Greed", "weeklyChange": 1.5},
    "Healthcare": {"currentScore": 48.3, "phase": "Neutral", "weeklyChange": -3.1}
  }
}

Score interpretation: 0-25 Extreme Fear, 26-40 Fear, 41-59 Neutral, 60-74 Optimism, 75-100 Greed.

Node SDK:

const mood = await client.marketMood.get();
console.log(mood.market.currentScore, mood.market.phase);

Documents & News API (/api/v1/documents)

> Note: Document responses include a url field but no headline or title text. The API provides derived analytics (sentiment, entities, reliability), not source content. The sourceName field identifies the publisher. If your application needs to display titles, the url field links to the original source. Any content retrieval from source URLs is your application's independent action, subject to the source platform's terms. See our API Terms of Service.

GET /api/v1/documents/ticker/{ticker}

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | source | string | No | all | NEWS, REDDIT, X, SUBSTACK | | days | int | No | 7 | Lookback in days (1-365) | | hours | int | No | - | Lookback in hours (overrides days) | | limit | int | No | 200 | Max results (capped at 200) |

Response: { documents: [...], totalCount, searchTicker, source, startDate, endDate }. Each document includes: id, url, source, sourceName, published, averageSentiment, reliability, sentiment[]. Per-entity sentiment classifies each mentioned entity as POSITIVE/NEGATIVE/NEUTRAL.

GET /api/v1/documents/ticker/{ticker}/range

| Param | Type | Required | Description | |-------|------|----------|-------------| | startDate | ISO date | Yes | e.g., 2025-01-01 | | endDate | ISO date | Yes | e.g., 2025-01-31 | | source | string | No | Filter by source | | limit | int | No | Max results (capped at 200) |

GET /api/v1/documents/entity/{entityId}

GET /api/v1/documents/search

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | query | string | Yes | - | e.g., AAPL earnings, Elon Musk TSLA | | source | string | No | all | Filter by source | | days | int | No | 7 | Lookback in days | | limit | int | No | 200 | Max results (capped at 500) |

GET /api/v1/documents/source/{source}

| Param | Type | Required | Description | |-------|------|----------|-------------| | source | path | Yes | NEWS, REDDIT, X, SUBSTACK | | days | int | No | Lookback in days | | limit | int | No | Max results (capped at 500) |

GET /api/v1/documents/stories

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | limit | int | No | 20 | Max stories (capped at 50) | | days | int | No | 7 | Lookback in days (max 15) | | offset | int | No | 0 | Pagination offset |

Response: Story objects with cluster.title, cluster.averageSentiment, displayTickers, impactScore (0-10), brokeAt.

GET /api/v1/documents/stories/ticker/{ticker}

Institutional Flows API (/api/v1/institutional)

Data from SEC 13F-HR filings. Filer categories: INDEX_FUND, HEDGE_FUND, ACTIVIST, PENSION, BANK, INSURANCE, MUTUAL_FUND, SOVEREIGN_WEALTH, ENDOWMENT, OTHER.

Important: All institutional endpoints (except /quarters) require a reportDate parameter. Always call GET /quarters first to get valid dates; do not hardcode them. Use the reportDate from the first (most recent) quarter in subsequent calls.

GET /api/v1/institutional/quarters

Response: array of { value, label, reportDate } objects sorted newest-first. Use the reportDate field (e.g., "2025-12-31") when calling other institutional endpoints.

GET /api/v1/institutional/flows

| Param | Type | Required | Description | |-------|------|----------|-------------| | reportDate | ISO date | Yes | The reportDate from /quarters (e.g., 2025-12-31) | | limit | int | No | Max results per direction (default: 50, max: 100) |

Response: { isPreview, previewReason, data: { inflows: [...], outflows: [...] } }. Each flow includes net share changes, new/closed positions, and per-category breakdowns (indexFundNetChange, hedgeFundNetChange, etc.). Flows are ranked by dollarFlowUsd (= netSharesChange × avgClosePrice): inflows DESC, outflows ASC. avgClosePrice is null and dollarFlowUsd is 0 for tickers without a cached quarterly price; clients should fall back to netSharesChange for those rows.

GET /api/v1/institutional/holders/{ticker}

| Param | Type | Required | Description | |-------|------|----------|-------------| | reportDate | ISO date | Yes | Quarter end date |

Response: { isPreview, previewReason, data: { ticker, companyName, reportDate, totalInstitutionalShares, holderCount, holders: [...] } }. The holder list is nested at data.holders (not data directly). Each holder includes filer name, category, shares, value, change type (NEW/INCREASED/DECREASED/SOLD_OUT/UNCHANGED).

GET /api/v1/institutional/activist

| Param | Type | Required | Description | |-------|------|----------|-------------| | reportDate | ISO date | Yes | Quarter end date |

GET /api/v1/institutional/bonds

| Param | Type | Required | Description | |-------|------|----------|-------------| | reportDate | ISO date | Yes | Quarter end date |

GET /api/v1/institutional/options

| Param | Type | Required | Description | |-------|------|----------|-------------| | reportDate | ISO date | Yes | Quarter end date |

GET /api/v1/institutional/institution/{slugOrCik}

Response: { isPreview, previewReason, data: { filerCik, displayName, urlSlug, filerCategory, totalValueUsd, holdingsCount, latestReportDate, quartersTracked, newPositions, increasedPositions, decreasedPositions, soldOutPositions, holdings: [...] } }. Holding objects include ticker, companyName, shares, valueUsd, changeType, sharesChange, sharesChangePct, portfolioWeight.

Insider Trading API (/api/v1/insider)

SEC Form 4 insider trading data: track buys, sells, awards, and exercises by company officers, directors, and 10%+ shareholders. Updated daily. Includes cluster buy detection (a historically bullish signal).

Insider relationships: OFFICER, DIRECTOR, TEN_PCT_OWNER, OTHER. Each filer also has independent officer, director, tenPctOwner booleans (a person can be both officer and director).

Transaction types: BUY, SELL, EXERCISE, AWARD, GIFT, OTHER.

GET /api/v1/insider/activity

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | lookbackDays | int | No | 90 | Days to look back (1-365) |

Response (Free/unauthenticated): { isPreview: true, previewReason: "LOGIN_REQUIRED" | "PRO_REQUIRED", data: { buys: [...], sells: [...] } }. PRO: { isPreview: false, data: { buys: [...], sells: [...] } }. Each entry: ticker, companyName, tradeCount, insiderCount, totalShares, totalValue, latestDate, latestInsider, latestTitle.

GET /api/v1/insider/trades/{ticker}

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | ticker | path | Yes | - | Stock ticker (e.g., AAPL) | | lookbackDays | int | No | 90 | Days to look back (1-365) |

Response: { isPreview: bool, previewReason: string|null, data: [...] }. Free: top 5 trades, PRO: full list. Each trade: insiderName, insiderTitle, insiderRelation, officer, director, tenPctOwner, transactionDate, filedDate, transactionCode, transactionType, securityTitle, sharesTransacted, pricePerShare, totalValue, sharesOwnedAfter, directOwnership, rule10b51.

client = SentiSenseClient(api_key="ss_live_YOUR_KEY")
trades = client.get_insider_trades("AAPL", lookback_days=90)
for t in trades["data"]:
    print(f"{t['transactionDate']} {t['insiderName']} {t['transactionType']} {t['sharesTransacted']} shares")

GET /api/v1/insider/cluster-buys

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | lookbackDays | int | No | 90 | Days to look back (1-365) |

Response: { isPreview: bool, previewReason: string|null, data: [...] }. Free: top 3 signals, PRO: full list. Each entry: { ticker, companyName, insiderCount, tradeCount, totalShares, totalValue, firstBuyDate, lastBuyDate }.

Politicians Trading API (/api/v1/politicians)

Congressional STOCK Act trading disclosures: purchases, sales, and exercises by U.S. Senators and Representatives. Updated daily from official filings.

Chambers: SENATE, HOUSE.

Transaction types: PURCHASE, SALE, EXCHANGE, OTHER.

Amount ranges: STOCK Act disclosures report dollar amounts as ranges (e.g., "$1,001 - $15,000"), not exact values. The API returns the raw range string plus parsed amountMin/amountMax.

GET /api/v1/politicians/activity

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | lookbackDays | int | No | 90 | Days to look back (1-365) |

Response: { isPreview, previewReason, data: [...] }. Each trade: politicianName, firstName, lastName, chamber, party, state, bioguideId, imageUrl, ticker, assetDescription, assetType, transactionType, transactionDate, disclosureDate, disclosureDelayDays, amountRange, amountMin, amountMax, owner, urlSlug.

client = SentiSenseClient(api_key="ss_live_YOUR_KEY")
activity = client.get_politician_activity(lookback_days=90)
for trade in activity["data"]:
    print(f"{trade['politicianName']} ({trade['party']}-{trade['state']}): {trade['transactionType']} {trade['ticker']}")

GET /api/v1/politicians/filings/{ticker}

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | ticker | path | Yes | - | Stock ticker (e.g., NVDA) | | lookbackDays | int | No | 90 | Days to look back (1-365) |

Response: same preview wrapper and trade object schema as /activity.

GET /api/v1/politicians/members

No parameters.

Response: { isPreview, previewReason, data: [...] }. Each entry: urlSlug, displayName, firstName, lastName, chamber, party, state, bioguideId, imageUrl, totalTrades, purchaseCount, saleCount, latestTradeDate.

GET /api/v1/politicians/member/{slug}

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | slug | path | Yes | - | Politician URL slug (from /members) |

Response: { isPreview, previewReason, data: { profile: {...}, recentTrades: [...], topTickers: [...] } }.

Insights API (/api/v1/insights)

AI-generated trading signals for stocks and the overall market. Each insight identifies a specific pattern: insider cluster buying, institutional position changes, volume anomalies, sentiment baseline deviations, and more. Sorted by urgency then confidence.

Insight fields: insightId, insightType, category (SENTIMENT/TRENDING/TECHNICAL/FUNDAMENTAL/PERSONALIZED), insightText, confidence (0.0-1.0), urgency (low/medium/high), generatedAt (epoch seconds), docRefs ([{url, type}]).

Response shape (all tiers): { isPreview, previewReason, data: [...] }. Free: top N insights, PRO: full list.

GET /api/v1/insights/stock/{ticker}

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | ticker | path | Yes | - | Stock ticker (e.g., AAPL) | | urgency | string | No | - | Filter by urgency: low, medium, or high | | insightType | string | No | - | Filter by type (e.g., insider_buy_signal) |

client = SentiSenseClient(api_key="ss_live_YOUR_KEY")
result = client.get_stock_insights("AAPL", urgency="high")
for i in result["data"]:
    print(f"[{i['urgency'].upper()}] {i['insightType']}: {i['insightText'][:80]}")

GET /api/v1/insights/stock/{ticker}/range

| Param | Type | Required | Description | |-------|------|----------|-------------| | ticker | path | Yes | Stock ticker (e.g. AAPL) | | startDate | ISO date | Yes | Inclusive | | endDate | ISO date | Yes | Inclusive, on or after startDate | | urgency | string | No | Filter by low, medium, or high | | insightType | string | No | Filter by insight type |

GET /api/v1/insights/market

No parameters required.

result = client.get_market_insights()
for i in result["data"]:
    print(f"[{i['urgency'].upper()}] {i['insightText'][:100]}")

GET /api/v1/insights/latest

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | limit | int | No | 50 | Max results, clamped to 1-200 | | urgency | string | No | - | Filter by urgency |

GET /api/v1/insights/user

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | limit | int | No | 20 | Max results, clamped to 1-100 | | category | string | No | - | Filter by category (SENTIMENT, INSIDER, INSTITUTIONAL, etc.) |

Response wrapper is {isPreview: false, previewReason: null, data: [...] } since the endpoint is auth-required.

GET /api/v1/insights/stock/{ticker}/types

| Param | Type | Required | Description | |-------|------|----------|-------------| | ticker | path | Yes | Stock ticker (e.g., AAPL) |

Response: string array, e.g. ["insider_buy_signal", "institutional_position_change", "volume_anomaly_high"].

Analyst Ratings API (/api/v1/analyst)

Wall Street analyst coverage: aggregate price target band, buy/hold/sell distribution, recent upgrade/downgrade actions, and forward EPS estimates with earnings surprise history. Free users still get the price target band (targetLow, targetMean, targetHigh, numberOfAnalysts, consensusLabel) in full -- it powers the public projection cone. The buy/hold/sell distribution counts and full action/estimate history are PRO-only.

GET /api/v1/analyst/{ticker}/consensus

| Param | Type | Required | Description | |-------|------|----------|-------------| | ticker | path | Yes | Stock ticker (e.g. AAPL) |

Response: { isPreview, previewReason, data: { ticker, currentPrice, targetLow, targetMean, targetHigh, targetMedian, numberOfAnalysts, upsidePercent, consensusLabel, recommendationMean, strongBuy, buy, hold, sell, strongSell, updatedAt } }. The five *Buy/*Sell/hold count fields are zero in the free preview. Returns 404 when no analyst coverage exists for the ticker.

GET /api/v1/analyst/{ticker}/actions

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | ticker | path | Yes | - | Stock ticker | | lookbackDays | int | No | 90 | Days of history to return |

Action object: { ticker, actionDate, firm, actionType (UPGRADE/DOWNGRADE/INITIATE/REITERATE/OTHER), fromGrade, toGrade }.

GET /api/v1/analyst/{ticker}/estimates

| Param | Type | Required | Description | |-------|------|----------|-------------| | ticker | path | Yes | Stock ticker |

Response: { isPreview, previewReason, data: { estimates: [...], surprises: [...] } }.

GET /api/v1/analyst/activity

| Param | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | lookbackDays | int | No | 30 | Days of history to return |

Same per-action shape as /api/v1/analyst/{ticker}/actions.

Market Summary API (/api/v1/market-summary)

AI-generated market overview with headline analysis and top active stocks.

GET /api/v1/market-summary

Response:

| Field | Type | Description | |-------|------|-------------| | totalMentions | long | Total mentions across all tracked stocks | | topActiveStocks | string[] | Most active tickers by mention volume | | lastUpdated | long | Epoch milliseconds when data was last updated | | headline | string? | 1-2 sentence market punchline | | expandedContent | string? | Full markdown analysis | | generatedAt | long? | Epoch seconds when AI summary was generated |

Error Codes

| Code | Meaning | |------|---------| | 200 | Success | | 400 | Bad request (missing/invalid parameters) | | 401 | Unauthorized (invalid or missing API key) | | 403 | Forbidden (insufficient tier) | | 404 | Resource not found | | 429 | Rate limit or quota exceeded | | 500 | Internal server error |

Getting Started

1. Sign up at app.sentisense.ai and generate a free API key in Settings > Developer Console 2. Start calling -- all you need is the API key in a header. No SDK install required:

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

3. Upgrade to PRO ($15/mo) for full institutional flows, AI reports, politician data, and 100K requests/month

SDKs (Optional Convenience)

SDKs are thin wrappers around the REST API. As an AI agent, you are encouraged to call endpoints directly with HTTP requests rather than installing packages. If you do want to use an SDK, review the source first:

Python: github.com/SentiSenseApp/sentisense (pip install sentisense)

from sentisense import SentiSenseClient
client = SentiSenseClient(api_key="ss_live_YOUR_KEY")
price = client.get_stock_price("AAPL")

Node.js: github.com/SentiSenseApp/sentisense-node (npm install sentisense)

import SentiSense from 'sentisense';
const client = new SentiSense({ apiKey: 'ss_live_YOUR_KEY' });
const price = await client.stocks.getPrice('AAPL');

> Note: This skill file is updated frequently as new features ship. For the latest version, check sentisense.ai/skill.md.

*SentiSense is a product of Compass AI Data Services, LLC. This data is for informational purposes only -- not investment advice.*

1. Sign up at app.sentisense.ai and generate a free API key in Settings > Developer Console 2. Start calling -- all you need is the API key in a header. No SDK install required:

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

3. Upgrade to PRO ($15/mo) for full institutional flows, AI reports, politician data, and 100K requests/month

SDKs (Optional Convenience)

SDKs are thin wrappers around the REST API. As an AI agent, you are encouraged to call endpoints directly with HTTP requests rather than installing packages. If you do want to use an SDK, review the source first:

Python: github.com/SentiSenseApp/sentisense (pip install sentisense)

from sentisense import SentiSenseClient
client = SentiSenseClient(api_key="ss_live_YOUR_KEY")
price = client.get_stock_price("AAPL")

Node.js: github.com/SentiSenseApp/sentisense-node (npm install sentisense)

import SentiSense from 'sentisense';
const client = new SentiSense({ apiKey: 'ss_live_YOUR_KEY' });
const price = await client.stocks.getPrice('AAPL');

> Note: This skill file is updated frequently as new features ship. For the latest version, check sentisense.ai/skill.md.

*SentiSense is a product of Compass AI Data Services, LLC. This data is for informational purposes only -- not investment advice.*