# SECret Sauce

> Real-time SEC Form 4 insider trading intelligence and U.S. Congressional trade disclosures platform.

SECret Sauce tracks, filters, and analyzes corporate insider buying and selling filed with the U.S. Securities and Exchange Commission (SEC Form 4) alongside legislative stock transactions disclosed by members of the U.S. Senate and House of Representatives.

## Agent & Machine-Readable Resources

- [ARD Capability Manifest](https://secsauce.fyi/.well-known/ai-catalog.json): Agentic Resource Discovery (ARD) ai-catalog.json capability manifest (application/json)
- [API Catalog](https://secsauce.fyi/.well-known/api-catalog): RFC 9727 linkset API catalog (application/linkset+json)
- [Agent Skills Discovery Index](https://secsauce.fyi/.well-known/agent-skills/index.json): Agent Skills Discovery RFC v0.2.0 index listing machine-readable skills and instructions
- [ARD Discovery Skill](https://secsauce.fyi/.well-known/agent-skills/ard/SKILL.md): Instructions for discovering tools, MCP servers, and APIs via ARD (text/markdown)
- [DNS-AID Discovery Skill](https://secsauce.fyi/.well-known/agent-skills/dns-aid/SKILL.md): DNS for AI Discovery (DNS-AID) SVCB and HTTPS record specification and well-known entry points (text/markdown)
- [Markdown Negotiation Skill](https://secsauce.fyi/.well-known/agent-skills/markdown-negotiation/SKILL.md): Instructions for requesting Markdown representations via Accept: text/markdown (text/markdown)
- [Auth.md Agent Registration](https://secsauce.fyi/auth.md): Machine-readable agent authentication and registration manifest (text/markdown)
- [OAuth Protected Resource Metadata](https://secsauce.fyi/.well-known/oauth-protected-resource): RFC 9728 protected resource metadata (application/json)
- [OAuth Authorization Server Metadata](https://secsauce.fyi/.well-known/oauth-authorization-server): RFC 8414 authorization server discovery with Auth.md agent_auth block (application/json)
- [OpenAPI 3.1 JSON Specification](https://secsauce.fyi/api/openapi.json): Full OpenAPI 3.1.0 specification (application/vnd.oai.openapi+json)
- [OpenAPI 3.1 YAML Specification](https://secsauce.fyi/api/openapi.yaml): Full OpenAPI specification in YAML (application/yaml)
- [Interactive API Documentation](https://secsauce.fyi/docs): Interactive API reference powered by Scalar (text/html)
- [Markdown for Agents](https://secsauce.fyi/): All pages support content negotiation via `Accept: text/markdown`
- [Sitemap](https://secsauce.fyi/sitemap.xml): XML sitemap listing indexable routes and tickers
- [System Health](https://secsauce.fyi/api/health): Health check and operational status endpoint

## Primary REST API Endpoints

All REST endpoints are available under the `https://secsauce.fyi/api` base path:

- `GET /api/dashboard/summary`: High-level market metrics, top conviction moves, active insider count, and recent filings.
- `GET /api/transactions`: Paginated SEC Form 4 insider transactions with conviction scoring (0-100), filters for ticker, transaction type (P/S), and officer title.
- `GET /api/congress-transactions`: Congressional stock disclosures filtered by chamber (Senate/House), political party, and politician name.
- `GET /api/opportunities/radar`: High-conviction insider trading setups filtered by multi-factor scoring algorithms.
- `GET /api/opportunities/clusters`: Multi-insider buying clusters (3+ insiders acquiring stock in a synchronized window).
- `GET /api/intel/double-conviction`: Dual alignment where corporate executives and politicians both bought the same ticker.
- `GET /api/intel/biotech-catalyst-alignment`: Insider purchases correlated with upcoming FDA PDUFA decision dates and clinical trial phase milestones.
- `GET /api/intel/short-squeeze-sentinel`: High short interest equities exhibiting heavy insider accumulation.
- `GET /api/intel/legislative-contract-alignment`: Congressional committee assignments mapped to federal procurement and defense awards.
- `GET /api/intel/activist-responses`: SEC Schedule 13D/13G activist campaigns and management response tracking.
- `GET /api/analytics/quant-potential`: Machine learning price target forecasts derived from insider momentum and historical alpha.
- `GET /api/analytics/quant-scorecard`: Historical win rate and performance benchmarks for predictive quant signals.
- `GET /api/analytics/etf-insights`: Cross-ETF holdings overlap and institutional fund exposure analysis.
- `GET /api/analytics/{symbol}`: Comprehensive analytical dossier for an individual equity.
- `GET /api/prices/current?symbols=AAPL,NVDA`: Batch real-time price quotes and daily percentage changes.
- `GET /api/prices/history/{symbol}`: Historical OHLCV candlestick series for charting.
- `GET /api/search/autocomplete?q=NVDA`: Instant search autocomplete for stock tickers, company names, and Congress members.
- `GET /api/tickers`: List of actively tracked equities with sector classifications.
- `GET /api/curated-sectors`: Thematic industry baskets for macro trend analysis.
- `POST /api/backtest`: Historical strategy backtesting for insider purchase holding models.

## WebMCP Browser Agent Tools

SECret Sauce exposes native WebMCP tools to AI agents via `navigator.modelContext` and `document.modelContext` on page load:

- `search_tickers`: Search tracked stock tickers or autocomplete by ticker symbol or company name.
- `get_insider_transactions`: Real-time SEC Form 4 insider buys and sells with filtering and pagination.
- `get_congress_transactions`: Congressional stock disclosure filings (Senate & House).
- `get_ticker_analytics`: Comprehensive equity analysis, prices, ML forecasts, and conviction scores.
- `get_conviction_score`: Multi-factor insider and politician conviction scoring breakdown.
- `get_cluster_signals`: Multi-insider cluster acquisition alerts.
- `get_politician_leaderboard`: Politician trader performance rankings.
- `get_rankings`: Top insider executives and politician rankings.
- `get_dashboard_summary`: Real-time market summary metrics and high-conviction trades.
- `get_quant_potential`: Quantitative ML opportunity price forecasts.
- `get_quant_scorecard`: Predictive model accuracy scorecard and win/loss records.
- `get_opportunity_radar`: Multi-factor algorithmic setup screener.
- `get_earnings_calendar`: Corporate earnings calendar with insider context.
- `get_etf_exposure`: Institutional ETF holdings overlap and exposure.
- `get_sector_details`: Sector intelligence and top constituent performance.
- `navigate_to_page`: Navigate the web application interface to any route or equity view.