# SentiSense API

> SentiSense provides market sentiment, news intelligence, institutional flow, insider, and congressional trading data via REST API.

## Base URL

https://app.sentisense.ai

## Authentication

All API access requires an API key via the `X-SentiSense-API-Key` header. Keys look like `ss_live_...`.
Free tier: 1,000 quota-gated requests/month at up to 30 requests/minute. PRO ($15/mo): no monthly cap, up to 300 requests/minute. Quota exhaustion and rate limiting both return HTTP 429.
Generate a key for free at https://app.sentisense.ai/get-api-key.

## Docs

Raw markdown mirrors below; human-readable versions live at https://sentisense.ai/docs/api/<slug>/.
The complete single-file agent reference is https://sentisense.ai/skill.md.

- [Stocks API](https://sentisense.ai/docs/api/stocks.md): Stock prices delayed 15 minutes, historical charts, company fundamentals, short interest data, and AI-powered stock analysis.
- [Documents & News API](https://sentisense.ai/docs/api/documents.md): Search and retrieve sentiment metrics for news articles, social media posts, and AI-curated news stories across multiple sources.
- [Metrics API](https://sentisense.ai/docs/api/metrics.md): Time series social metrics for stocks and entities: mentions, sentiment, SentiSense Score, and social dominance, with distributions and baselines.
- [Market Mood API](https://sentisense.ai/docs/api/market-mood.md): SentiSense's proprietary fear and greed index plus the market-wide sentiment rollups: a 0-100 composite score, per-sector tone versus the market, and daily sentiment breadth.
- [Market Summary API](https://sentisense.ai/docs/api/market-summary.md): AI-generated market headline and expanded analysis, refreshed through the trading day: what moved, why it moved, and which stocks are most active.
- [Insights API](https://sentisense.ai/docs/api/insights.md): AI-generated insights for stocks and the overall market. Each flags a specific signal, from insider cluster buying to institutional rotation, with scores.
- [Institutional Flows API](https://sentisense.ai/docs/api/institutional-flows.md): SEC 13F-HR filing data: market flows, institutional holders, activist positions, and options activity. Track what funds and banks are buying and selling.
- [Insider Trading API](https://sentisense.ai/docs/api/insider-trading.md): Track SEC Form 4 insider filings: buys, sells, awards, and exercises by officers, directors, and 10%+ shareholders, with cluster buy detection.
- [Politicians Trading API](https://sentisense.ai/docs/api/politicians.md): Track congressional STOCK Act trading disclosures: purchases, sales, and exercises by U.S. Senators and Representatives. Updated daily from official filings.
- [Analyst Ratings API](https://sentisense.ai/docs/api/analyst-ratings.md): Wall Street analyst price targets, buy/hold/sell distribution, upgrade and downgrade actions, and forward EPS estimates with earnings surprise history.
- [Earnings Analysis API](https://sentisense.ai/docs/api/earnings.md): The earnings lifecycle as one API family: who reports (calendar), what management changed in its SEC filings (risk-factor diffs), the per-quarter analysis of what was actually reported, and the AI takeaway (insights).
- [Calendar API](https://sentisense.ai/docs/api/calendar.md): Forward-looking earnings calendar API: upcoming report dates with session timing, fiscal quarter, confirmation status, and consensus EPS estimates.
- [ETFs API](https://sentisense.ai/docs/api/etfs.md): ETF discovery, holdings composition, and holdings-weighted aggregates: analyst consensus, insider activity, and sentiment derived from fund constituents.
- [Indexes API](https://sentisense.ai/docs/api/indexes.md): SentiSense's composite sentiment indexes in one standardized envelope: a single scalar per index, its history, and the constituent breakdown behind it.
- [Trackers API](https://sentisense.ai/docs/api/trackers.md): Observational market trackers in one standardized envelope: institution rankings, hedge fund returns, Reddit positioning, and sentiment leaderboards.
- [Options Intelligence API](https://sentisense.ai/docs/api/options.md): End-of-day options analytics ranked against each stock's own history: IV rank, put/call percentile, 25-delta skew, open-interest walls, max pain, and unusual contracts, plus a market-wide radar.
- [Screener API](https://sentisense.ai/docs/api/screener.md): Filter the tracked universe on the SentiSense Score, the SentiSense Rating letter, attention, analyst consensus, technicals and price in a single query, and read the field catalog that backs it.
- [MCP Connector](https://sentisense.ai/docs/api/connectors.md): Connect SentiSense to Claude, ChatGPT, and Grok with one URL. Ten read-only MCP tools: market mood, stock snapshots, the SentiSense Rating, news, analyst ratings, 13F flows, options intelligence, the earnings calendar, per-company financial statements, and a stock/ETF screener.
- [Agent Skills](https://sentisense.ai/docs/api/agent-skills.md): Install SentiSense skills into Claude Code, Cursor, Codex, Gemini, or OpenClaw with one command. Twenty-one read-only skills: the full API reference, the official CLI, a stock screener, a stock terminal, committee-style stock analysis, earnings analysis, company KPI tracking, analyst ratings tracking, insider Form 4 tracking, a monthly market brief, a dashboard builder, a market heatmap, options activity, an expected-move visualizer, an options payoff calculator, a position-size calculator, 13F flows, politician trades, stock sentiment, a company knowledge graph, and an onboarding router.
- [Entities API](https://sentisense.ai/docs/api/entities.md): Search the SentiSense ontology for the people, companies, products, and organizations we track, and query their SentiSense Score, sentiment, and mentions.
- [SentiSense Rating API](https://sentisense.ai/docs/api/sentisense-rating.md): The daily 0 to 100 score and A to F letter grade for a US stock: the rank of a seven-dimension blend of crowd sentiment, smart money, options positioning, analysts, fundamentals, earnings and technicals, less its graded risk adjustments, with the full composition behind it.

## Python Client

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