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.

Request Format

Understand the universal request body structure.

Response Format

Learn how responses are structured with pagination.

API Reference

Explore all available endpoints and try them live.

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

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" }
  }'