Heisenberg SDK

One typed client for the entire intelligence API — markets, trades, wallet 360, smart money, H-Score leaderboards, CLV, and real-time trades — for TypeScript and Python, generated from a single spec so both languages stay identical.

Quickstart

import { Heisenberg } from 'heisenberg-ai';

const hb = new Heisenberg({ token: process.env.HEISENBERG_TOKEN });

// Free tier — no subscription needed.
const markets = await hb.polymarket.markets({ min_volume: 1000, closed: false, limit: 5 });
const profile = await hb.wallets.profile('0xabc…', { window_days: 15 });

// A Query is awaitable (first page) or async-iterable (auto-paginates).
for await (const trade of hb.polymarket.trades({ condition_id: '0x…' })) {
    // …
}

from heisenberg import Heisenberg

hb = Heisenberg(token="…")  # or set HEISENBERG_TOKEN

markets = hb.polymarket.markets({"min_volume": 1000, "closed": False, "limit": 5}).page()
profile = hb.wallets.profile("0xabc…", {"window_days": 15}).page()

for trade in hb.polymarket.trades({"condition_id": "0x…"}):  # auto-paginates
    ...

Two ways in

What the client handles for you

• Native param types → the API's string wire format (booleans, dates).
• Envelope unwrapping and auto-pagination.
• Encoded JSON response columns decoded transparently.
• Retries with backoff on 429/5xx.
• Typed errors — including PlanError for gated endpoints, which preserves the API message and tells you which plan unlocks it.

Method → endpoint reference

Every SDK method calls one API endpoint (agent). Names below are TypeScript; Python uses the snake_case equivalent (e.g. hb.smartMoney → hb.smart_money, closingLine → closing_line). Click an endpoint to open its full API reference.

Related

• Authentication — get a token and understand plans.
• API Reference — every endpoint, params, and response fields.
• WebSockets — the raw stream behind hb.stream.
• Work with AI (MCP) — no-code access to the same data.
• Pricing & Plans — what unlocks the gated endpoints.