> For the complete documentation index, see [llms.txt](https://prediction.heisenberg.so/llms.txt). For the full markdown concatenation, see [llms-full.txt](https://prediction.heisenberg.so/llms-full.txt).

Getting Started

# Welcome to Heisenberg

The most comprehensive prediction market intelligence API. Unified access to Polymarket, Kalshi, and social signals — through a single endpoint or Claude MCP integration.

Sub-300ms latency

Seconds-fresh data

Zero rate-limit concerns

## Base URL

https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized

[

Authentication

Learn how to authenticate your requests with API keys.

](/docs/getting-started/authentication)[

Request Format

Understand the universal request body structure.

](/docs/getting-started/request-format)[

Response Format

Learn how responses are structured with pagination.

](/docs/getting-started/response-format)[

API Reference

Explore all available endpoints and try them live.

](/docs/api-reference)

## Make Your First Request

All endpoints use a single POST endpoint. Pass the `agent_id` to select the data source and `params` to filter results.

cURL

```bash
curl -X POST \
  https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "agent_id": 574,
    "params": {
      "min_volume": "1000",
      "closed": "False"
    },
    "pagination": { "limit": 10, "offset": 0 },
    "formatter_config": { "format_type": "raw" }
  }'
```