# BullrunData — Market Intelligence API

> Real-time recession probability, US housing cycle regime detection, sector rotation, institutional positioning intelligence, and a full library of macro indicators via REST API and MCP server.

## Product

BullrunData is a market intelligence platform. We provide recession probability, US housing cycle regime detection, market regime and Fed stance detection, sector rotation signals, institutional positioning, and macro indicators through a REST API and an MCP server for AI agents. Built for fintech developers, AI agents, and institutional traders.

## Base URL

- API: https://api.bullrundata.com
- All endpoints require an X-API-Key header. Get a free key at https://bullrundata.com/login (100 calls/day).

## OpenAPI Specification

- Machine-readable spec: https://api.bullrundata.com/openapi.json
- Interactive playground: https://api.bullrundata.com/docs
- llms.txt (this file): https://bullrundata.com/llms.txt
- Agent instructions (concept-to-endpoint mapping, hallucination blacklist, examples): https://bullrundata.com/skill.md

## REST Endpoints

### Dashboard
- GET https://api.bullrundata.com/api/v1/dashboard/summary — one-call market intelligence with recession probability, market regime, Fed stance, and key metrics
- GET https://api.bullrundata.com/api/v1/dashboard/snapshot — all indicators grouped by category

### Recession Model (Pro tier)
- GET https://api.bullrundata.com/api/v1/model/probability — live recession probability with confirmation layer
- GET https://api.bullrundata.com/api/v1/model/probability/history?range=1y — historical probability snapshots

### Housing Cycle Model (Pro tier)
- GET https://api.bullrundata.com/api/v1/model/housing — US housing cycle regime classifier with composite score, regime, confidence, and component breakdown

### Economic Indicators
- GET https://api.bullrundata.com/api/v1/indicators — all latest indicators with weekly change data
- GET https://api.bullrundata.com/api/v1/indicators/{series} — single indicator by series ID (e.g. UNRATE, DFF, VIXCLS)
- GET https://api.bullrundata.com/api/v1/indicators/{series}/timeseries?range=1y — full time-series with min/max/change stats
- GET https://api.bullrundata.com/api/v1/indicators/{series}/history — historical values
- GET https://api.bullrundata.com/api/v1/categories — list of indicator categories

### Sector Rotation
- GET https://api.bullrundata.com/api/v1/sectors/rotation — S&P sector momentum ranking with defensive vs cyclical classification
- GET https://api.bullrundata.com/api/v1/sectors/flows?lookback=14 — per-sector accumulation/distribution signals

### Institutional Positioning
- GET https://api.bullrundata.com/api/v1/institutional/tic — foreign holdings of US Treasuries
- GET https://api.bullrundata.com/api/v1/institutional/cftc — curated positioning summary
- GET https://api.bullrundata.com/api/v1/institutional/cftc/contracts — list available contracts
- GET https://api.bullrundata.com/api/v1/institutional/cftc/positioning?contract=... — detailed smart-money breakdown with WoW changes

### Webhook Alerts
- POST https://api.bullrundata.com/api/v1/alerts/configure — set threshold-based webhook alerts
- GET https://api.bullrundata.com/api/v1/alerts/configured — list your configured alerts
- DELETE https://api.bullrundata.com/api/v1/alerts/{id} — remove a webhook alert

## MCP Server (for AI agents)

- Install: `npx @bullrundata/market-intelligence-mcp`
- Package: https://www.npmjs.com/package/@bullrundata/market-intelligence-mcp
- Hosted MCP endpoint: https://market.bullrundata.com/mcp

MCP tools cover recession analysis, US housing cycle, market regime, Fed stance, sector rotation, sector flows, institutional positioning, macro indicators, cascade scenario analysis, and investment calculators.

## Pricing

- Free: 100 calls/day, macro indicators + sector rotation + CFTC positioning + dashboard snapshot, 10 webhook alerts. Recession model and housing cycle model return a Pro-upgrade placeholder for free-tier callers.
- Pro ($29/mo): 10,000 calls/day, full recession probability model + US housing cycle model + market regime + Fed stance + 5-year historical data, 50 webhook alerts
- Enterprise ($99/mo): 100,000 calls/day, maximum historical data, 200 webhook alerts

## Content Pages

- Homepage: https://bullrundata.com
- API Documentation: https://bullrundata.com/docs
- Pricing: https://bullrundata.com/pricing
- Indicator library: https://bullrundata.com/indicators
- Glossary: https://bullrundata.com/glossary
- Changelog: https://bullrundata.com/changelog
- Use cases: https://bullrundata.com/use-cases/recession-probability-api
- Comparison: https://bullrundata.com/vs/nasdaq-data-link

## Links

- Website: https://bullrundata.com
- GitHub: https://github.com/BullrunData
- Support: support@bullrundata.com

## Author

Jayson Sun — Founder of BullrunData