Developer Reference

API Documentation

SentiSense is a US stock market data API and MCP connector for AI agents: news and social sentiment, the SentiSense Score, insider and congressional trades, 13F holdings, options positioning, analyst ratings and earnings, on one free API key.

Changelog →

REST

API

Direct HTTP access. Key-authenticated, JSON, Python and Node SDKs.

111 endpoints

Connector

MCP

Connect Claude or ChatGPT with one URL. OAuth, no API key to paste.

11 tools

Agent

Skills

Install into Claude Code, Cursor, Codex, or Gemini with one command.

21 skills

Quick Start

All API access requires an API key. Generate one for free in Settings > Developer Console.

# Get latest stock price (15-minute delayed)
curl -H "X-SentiSense-API-Key: ss_live_YOUR_KEY" \
  "https://app.sentisense.ai/api/v1/stocks/price?ticker=AAPL"

# Get institutional flows (PRO)
curl -H "X-SentiSense-API-Key: ss_live_YOUR_KEY" \
  "https://app.sentisense.ai/api/v1/institutional/flows?reportDate=2025-12-31"

PyPI →npm →GitHub →

API Reference

111 endpoints

Sentiment & News

Our proprietary layer, and the most-called

Market Mood API3SentiSense'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.Metrics API5Time series social metrics for stocks and entities: mentions, sentiment, SentiSense Score, and social dominance, with distributions and baselines.SentiSense Rating API1The 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.Insights API6AI-generated insights for stocks and the overall market. Each flags a specific signal, from insider cluster buying to institutional rotation, with scores.Documents & News API9Search and retrieve sentiment metrics for news articles, social media posts, and AI-curated news stories across multiple sources.Market Summary API1AI-generated market headline and expanded analysis, refreshed through the trading day: what moved, why it moved, and which stocks are most active.

Stocks & Estimates

Per-ticker facts and street forecasts

Stocks API29Stock prices delayed 15 minutes, OHLCV chart history, fundamentals with up to 40 quarters of history, short interest, company KPIs, the per-ticker SentiSense Score with its drivers, and AI stock reports.Analyst Ratings API9Wall Street analyst price targets, buy/hold/sell distribution, upgrade and downgrade actions, and forward EPS and revenue estimates with earnings surprise history.Calendar API2Earnings schedule API: report dates with session timing, fiscal quarter, confirmation status, and consensus EPS estimates.Earnings Analysis API6Per-quarter earnings reports, SEC risk-factor diffs between consecutive filings, the price reaction to each of the last 12 reports, recent reporters, the market-wide beat rate, and importance-ranked upcoming reporters.ETFs API6ETF discovery, holdings composition, and holdings-weighted aggregates: analyst consensus, insider activity, and sentiment derived from fund constituents.Options Intelligence API4End-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 API4Filter the tracked universe on the SentiSense Score, the SentiSense Rating letter, attention, analyst consensus, technicals, end-of-day options readings and price in a single query, and read the field catalog that backs it.

Entities

Resolve a person, product, or organization to a handle

Entities API3Search the SentiSense ontology for the people, companies, products, and organizations we track, and query their SentiSense Score, sentiment, and mentions.

Alternative Data

Disclosure filings, composite indexes, and observational trackers

Institutional Flows API9SEC 13F-HR filing data: market flows, institutional holders, activist positions, and options activity. Track what funds and banks are buying and selling.Insider Trading API3Track SEC Form 4 insider filings: buys, sells, awards, and exercises by officers, directors, and 10%+ shareholders, with cluster buy detection.Politicians Trading API5Congressional STOCK Act trading disclosures from official filings: purchases, sales and exchanges by U.S. Senators and Representatives, by member or by ticker.Indexes API3SentiSense's composite sentiment indexes in one standardized envelope: a single scalar per index, its history, and the constituent breakdown behind it.Trackers API2Observational market trackers in one standardized envelope: institution rankings, hedge fund returns, Reddit positioning, and sentiment leaderboards.

Rate Limits

Tier	Price	API Requests / Month	Key Features
Free	$0	1,000	Preview access, 30 req/min: generate key in Developer Console
PRO	$6.75/mo $15/mo55% off with FALL26	Unlimited	Full access, 300 req/min: institutional data, AI analysis

Agent Ready

Build with Your AI Agent

Point your AI agent to our skill file and it can query stock prices, sentiment data, news, and institutional flows, no manual setup needed.

✓111 REST API endpoints, most publicly accessible

✓Python & Node.js SDKs

✓Free tier: start calling endpoints immediately

agent prompt

// Point your AI agent here:

Read https://sentisense.ai/skill.md and follow the API instructions

Works with OpenClaw, Claude Code, Codex, and other AI agents.