# Heisenberg
> Heisenberg is a prediction market intelligence platform. It exposes production agents and a direct REST API over Polymarket and Kalshi data, including H-Score sharp-trader rankings, Wallet 360 analytics, market pulse, smart-money positions, and copy-trade signals. Connect via the MCP endpoint at https://narrative.agent.heisenberg.so/sse or the REST API documented at https://prediction.heisenberg.so/docs/api-reference. Every page is available as markdown by appending .md to the URL (e.g. https://prediction.heisenberg.so/docs/getting-started.md).
## Docs

- [Welcome to Heisenberg](https://prediction.heisenberg.so/docs/getting-started.md): Platform overview, first call in 60 seconds, and where to go next.
- [Concepts](https://prediction.heisenberg.so/docs/concepts.md): How Heisenberg works — agents, scoring, and intelligence outputs.
- [Work with AI (MCP)](https://prediction.heisenberg.so/docs/getting-started/mcp.md): Connect Claude or any MCP-compatible agent to Heisenberg.
- [Direct API](https://prediction.heisenberg.so/docs/getting-started/direct-api.md): REST access for trading systems, analytics pipelines, and bots.
- [Pricing & Plans](https://prediction.heisenberg.so/docs/getting-started/pricing.md): Credit weights, tier limits, and how requests are metered.
- [Trading & Execution](https://prediction.heisenberg.so/docs/use-cases/trading-platforms.md): Edge detection, CLV tracking, sharp-money signals for live markets.
- [LLM & Agent Pipelines](https://prediction.heisenberg.so/docs/use-cases/ai-agents.md): Wiring structured market intelligence into agent workflows.
- [Dashboards & Signals](https://prediction.heisenberg.so/docs/use-cases/analytics-research.md): Research, analytics, and dashboard integrations.
- [H-Score Methodology](https://prediction.heisenberg.so/docs/concepts/h-score-methodology.md): Sharp-money trader scoring model — inputs, math, and stability.
- [Data Foundation](https://prediction.heisenberg.so/docs/concepts/data-foundation.md): Sources, freshness, coverage, and historical depth.
- [Intelligence Outputs](https://prediction.heisenberg.so/docs/concepts/intelligence-outputs.md): Wallet 360, Market Pulse, Smart Money, and copy-trade signals.
- [Streaming & Reliability](https://prediction.heisenberg.so/docs/concepts/streaming.md): Realtime delivery, SLOs, and reconnection semantics.

## API

- [API Reference — Getting Started](https://prediction.heisenberg.so/docs/api-reference.md): REST quickstart, base URL, and authentication overview.
- [Authentication](https://prediction.heisenberg.so/docs/getting-started/authentication.md): API keys, JWT flow, and credential rotation.
- [Request Format](https://prediction.heisenberg.so/docs/getting-started/request-format.md): Request body schema, parameter conventions, and examples.
- [Response Format](https://prediction.heisenberg.so/docs/getting-started/response-format.md): Envelope, pagination, and standard response types.
- [Error Handling](https://prediction.heisenberg.so/docs/getting-started/errors.md): Error codes, retry semantics, and debugging guidance.
- [SDKs & Libraries](https://prediction.heisenberg.so/docs/getting-started/sdks.md): Official client libraries and language coverage.
- [Migration Guide](https://prediction.heisenberg.so/docs/getting-started/migration.md): Version transitions and upgrade paths.
- [Glossary](https://prediction.heisenberg.so/docs/getting-started/glossary.md): Domain terms: H-Score, CLV, smart money, wallet 360, market pulse.

## Public API Endpoints

- [Polymarket Markets](https://prediction.heisenberg.so/docs/api-reference/polymarket-markets.md): Polymarket
- [Polymarket Trades](https://prediction.heisenberg.so/docs/api-reference/polymarket-trades.md): Polymarket
- [Polymarket Candlesticks](https://prediction.heisenberg.so/docs/api-reference/polymarket-candlesticks.md): Polymarket
- [Polymarket Price Jumps](https://prediction.heisenberg.so/docs/api-reference/polymarket-price-jumps.md): Polymarket
- [Polymarket Orderbook](https://prediction.heisenberg.so/docs/api-reference/polymarket-orderbook.md): Polymarket
- [Polymarket PnL](https://prediction.heisenberg.so/docs/api-reference/polymarket-pnl.md): Polymarket
- [Polymarket PnL Leaderboard](https://prediction.heisenberg.so/docs/api-reference/polymarket-pnl-leaderboard.md): Polymarket
- [Wallet Stats All Time](https://prediction.heisenberg.so/docs/api-reference/wallet-stats-all-time.md): Polymarket
- [Heisenberg Leaderboard](https://prediction.heisenberg.so/docs/api-reference/heisenberg-leaderboard.md): Polymarket
- [Wallet 360](https://prediction.heisenberg.so/docs/api-reference/wallet-360.md): Polymarket
- [Polymarket Market 360](https://prediction.heisenberg.so/docs/api-reference/polymarket-market-360.md): Polymarket
- [Kalshi Markets](https://prediction.heisenberg.so/docs/api-reference/kalshi-markets.md): Kalshi
- [Kalshi Trades](https://prediction.heisenberg.so/docs/api-reference/kalshi-trades.md): Kalshi
- [Social Pulse](https://prediction.heisenberg.so/docs/api-reference/social-pulse.md): Social Intelligence

## Gated API Endpoints (subscription required)

- [Sport H-Score Leaderboard](https://prediction.heisenberg.so/docs/api-reference/sport-h-score-leaderboard.md): Bettor Analytics
- [Sport Wallet 360](https://prediction.heisenberg.so/docs/api-reference/sport-wallet-360.md): Bettor Analytics
- [Sport PnL](https://prediction.heisenberg.so/docs/api-reference/sport-pnl.md): Bettor Analytics
- [Smart Money Positions](https://prediction.heisenberg.so/docs/api-reference/smart-money-positions.md): Smart Money Tracking
- [Market Pulse: Summary](https://prediction.heisenberg.so/docs/api-reference/market-pulse-summary.md): Smart Money Tracking
- [Market Pulse: Positions](https://prediction.heisenberg.so/docs/api-reference/market-pulse-positions.md): Smart Money Tracking
- [Sport Market Insights](https://prediction.heisenberg.so/docs/api-reference/sport-market-insights.md): Market Quality & Signals
- [Closing Line](https://prediction.heisenberg.so/docs/api-reference/closing-line.md): Market Quality & Signals
- [Price Jumps](https://prediction.heisenberg.so/docs/api-reference/price-jumps.md): Market Quality & Signals
- [Sport Trades](https://prediction.heisenberg.so/docs/api-reference/sport-trades.md): Market & Trade Data
- [Polymarket Markets](https://prediction.heisenberg.so/docs/api-reference/polymarket-markets.md): Market & Trade Data
- [Polymarket Candlesticks](https://prediction.heisenberg.so/docs/api-reference/polymarket-candlesticks.md): Market & Trade Data
- [Polymarket Orderbook](https://prediction.heisenberg.so/docs/api-reference/polymarket-orderbook.md): Market & Trade Data
- [Analyze Market](https://prediction.heisenberg.so/docs/api-reference/analyze-market.md): Composite Workflows
- [Scout Wallet](https://prediction.heisenberg.so/docs/api-reference/scout-wallet.md): Composite Workflows
- [Batch Wallet Trades](https://prediction.heisenberg.so/docs/api-reference/batch-wallet-trades.md): Composite Workflows
- [Batch Market Resolution](https://prediction.heisenberg.so/docs/api-reference/batch-market-resolution.md): Composite Workflows

## Optional

- [Account](https://prediction.heisenberg.so/docs/dashboard/account.md): Plan, billing, and team management.
- [Playground](https://prediction.heisenberg.so/docs/dashboard/playground.md): Interactive API console.
- [WebSockets](https://prediction.heisenberg.so/docs/websockets.md): Realtime streaming protocol (coming soon).
- [Research Data](https://prediction.heisenberg.so/docs/research-data.md): Historical datasets and bulk exports.