# Hunch Full LLM Context

Hunch helps users discover and trade prediction markets across supported venues. Public surfaces focus on live market discovery, event odds, cross-venue arbitrage clusters, wallet-intelligence entry points, rewards information, and machine-readable context.

## Public Pages
- Live Prediction Markets: https://app.hunch.trade/ - Tradeable prediction market feed with odds, volume, liquidity, venues, filters, and event links.
- Arbitrage: https://app.hunch.trade/arbitrage - Cross-venue market clusters and price discrepancies surfaced for arbitrage analysis.
- Discovery: https://app.hunch.trade/discovery - Market and event discovery tools for topical exploration.

## Public API Plan
The frontend exposes machine-readable discovery surfaces now. The canonical public API should be served by the backend under /public/* and described by /openapi.json when those backend endpoints exist.
- /public/markets: List tradeable markets. Returns a public catalog of active tradeable prediction markets with titles, venues, odds, volume, liquidity, event links, and timestamps.
- /public/markets/{marketId}: Get a market. Returns public details for one tradeable market, including outcomes, prices, liquidity, volume, venue identifiers, and source URLs.
- /public/events/{eventId}: Get an event. Returns public event details plus the tradeable contracts grouped under that event.
- /public/arbitrage/clusters: List arbitrage clusters. Returns public cross-venue clusters, spread metrics, liquidity, confidence, analysis labels, and related markets.
- /public/arbitrage/clusters/{clusterId}: Get an arbitrage cluster. Returns one public arbitrage cluster with constituent markets and analysis metadata.

## Structured Data
Site-level Organization, WebSite, and SearchAction JSON-LD are emitted globally. Market and event pages emit Event and FinancialProduct-style JSON-LD when server-side market data is available.

## Terminology
A hunch is a directional prediction. A strong hunch is a high-confidence directional signal. Liquidity is capital available for execution. Volume is executed trading activity. Open interest is outstanding market exposure. An arbitrage cluster is a group of related markets where cross-venue prices imply a potential spread.

## Private Surfaces
Agents should avoid /portfolio, /proof, /api/hunch, authenticated wallet routes, and user-specific tracking URLs unless explicitly acting for an authenticated user with permission.