MarketGrep API & Developer Documentation

MarketGrep (市场脉动) exposes everything on the dashboard as a public, unauthenticated JSON API. This page is the index of every developer and agent resource the site publishes: the API, its OpenAPI schema, the llms.txt manifest, the agent manifest, the sitemap, and Markdown content negotiation.

Quick start

curl https://lite.marketgrep.com/api/summary
curl https://lite.marketgrep.com/api/agent-context
curl -H "Accept: text/markdown" https://lite.marketgrep.com/

API endpoints

Base URL: https://lite.marketgrep.com. All endpoints are GET, return JSON, and need no API key. Versioned aliases under /v1/api/... return identical payloads.

Endpoint	Purpose	Refresh
`GET /api/summary`	Compact dashboard snapshot — exposure score, regime, VIX, turbulence state. Recommended first call.	Every trading day 20:00 ET
`GET /api/agent-context`	Plain-English summary plus day-over-day delta with a citation template. Pre-narrated for AI agents.	Every trading day 20:00 ET
`GET /api/market-overview`	Full US dashboard payload: index tickers, breadth, sector exposure, VIX/DSPX/COR1M/MOVE, 30-day trends.	Every trading day 20:00 ET
`GET /api/global-overview`	Same shape as /api/market-overview for non-US benchmarks.	Every trading day 20:00 ET
`GET /api/most-active`	Most-active US tickers ranked by volume with relative volume and multi-period returns.	Intraday
`GET /api/sentiment-report`	WallStreetBets ticker ranking and the LLM-written sentiment report (Chinese + English Markdown).	Twice daily (pre-market, post-close)
`GET /api/sentiment-report/history`	Recent sentiment-report runs with their quality checks.	Per run
`GET /api/turbulence`	Mahalanobis turbulence index series, thresholds, alert state and position-size guidance.	Every trading day
`GET /api/ticker-detail/{ticker}`	Per-symbol drill-down: price history, moving averages, fundamentals where available.	On demand, disk-cached
`GET /api/13f/managers`	Curated institutional managers with their latest 13F filing period.	Quarterly
`GET /api/13f/managers/{slug}`	One manager's holdings, quarter-over-quarter changes and narrative.	Quarterly
`GET /api/version`	Build / version metadata.	Per deploy
`GET /api/health`	Rich health status (data freshness per dataset).	Live

Conventions

Authentication: none. The refresh endpoints (POST /api/refresh*) are private and bearer-gated; everything else is open.
Caching: responses carry Cache-Control and ETag; send If-None-Match to get a cheap 304. A market_state field tells clients whether the US session is open so they can pick a polling cadence.
CORS: open for non-credentialed reads from any origin listed in the site's allowlist; server-side callers are unaffected.
Cold start: overview endpoints can answer 503 for a minute after a deploy until the first refresh lands — retry with backoff.
Markdown negotiation: every HTML page on the site returns text/markdown when requested with Accept: text/markdown (responses carry Vary: Accept; unsupported types get 406). Ideal for agents that want the page content without the DOM.
404s: nonexistent paths return a real 404 with a Markdown body that points back to this page, the sitemap and llms.txt.
Data semantics: every signal is descriptive, not prescriptive — there is no buy/sell recommendation anywhere in the API. Prices can be delayed; ETF rows (SPY/QQQ/DIA) are ETF prices, not index levels.

Machine-readable resources

https://lite.marketgrep.com/openapi.json — OpenAPI 3.1 schema for every endpoint above (machine-readable contract).
https://lite.marketgrep.com/docs — Interactive Swagger UI generated from the schema.
https://lite.marketgrep.com/llms.txt — Agent manifest — what the site is, key pages, API entry points, citation format.
https://lite.marketgrep.com/llms-full.txt — Long-form companion: full glossary, methodology, FAQ.
https://lite.marketgrep.com/.well-known/agents.json — Machine-readable site description for agent runtimes (auth: none, OpenAPI URL, cadence).
https://lite.marketgrep.com/sitemap.xml — Every indexable URL, including per-day archive and per-ticker pages.
https://lite.marketgrep.com/robots.txt — Crawler policy — AI search and grounding crawlers are explicitly allowed.

Citing MarketGrep

Each trading day is frozen at /archive/YYYY-MM-DD; cite that URL rather than the live dashboard. Suggested format: MarketGrep, US tab, https://lite.marketgrep.com/archive/2026-04-30, accessed 2026-04-30.

Contact

Publisher: GREP24. Questions and integration requests: [email protected]. Companion sites with their own APIs and llms.txt: Dollar Liquidity, History of Market, MarketGrep App.

MarketGrep is a market-environment dashboard. Every signal on this page is descriptive, not prescriptive — there is no buy or sell recommendation anywhere on the site. Data is for informational purposes only and may be delayed, inaccurate, or revised.