llms.txt Content
# BullrunData — Market Intelligence API
> Real-time recession probability, 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, 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
- 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
### 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}/
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"BullrunData Market Intelligence API","description":"BullrunData Market Intelligence API — Economic indicators, recession probability, capital rotation tracking, and market regime analysis.\n\n**Authentication:** All `/api/v1/*` endpoints require an API key via the `X-API-Key` header.\n\n**Rate Limits:** Free tier: 100 req/day · Pro: 10k/day · Enterprise: 100k/day\n\nGet your API key at [bullrundata.com](https://bullrundata.com)","version":"2.0.0"},"paths":