Glossary
Key terms used across the Heisenberg API and prediction market ecosystem.
Heisenberg
agent_idInteger that identifies which data endpoint to query. Each Heisenberg endpoint (Markets, Trades, Wallet 360, etc.) has a unique agent_id. Passed in the request body.
H-ScoreProprietary 0–100 composite score measuring a wallet's prediction market trading skill. Factors in profitability, accuracy, consistency, risk management, and diversification.
Wallet 360Comprehensive wallet intelligence profile with 60+ computed metrics covering performance, risk, behavior, and activity patterns.
Market 360Market quality and health assessment — liquidity depth, volume dynamics, whale concentration, and price stability.
formatter_configRequest body field controlling response format. Use {"format_type": "raw"} for structured JSON responses.
has_moreBoolean in the pagination response. When true, more results exist beyond the current page. Increment offset by limit to fetch the next page.
Polymarket
condition_idHex string uniquely identifying a market (question) on Polymarket. A market can have multiple outcomes, each with its own token_id. Example: 0xbcacd5a055f5...
token_idLarge integer identifying a specific outcome token within a Polymarket market. Each side of a binary market (Yes/No) has its own token_id. Used for trading and price queries.
proxy_walletThe Polymarket proxy wallet address associated with a user. This is the address that executes trades on-chain, not the user's EOA.
Trading
PnLProfit and Loss — the net financial result of a wallet's trading activity. Can be realized (closed positions) or unrealized (open positions).
OHLCVOpen, High, Low, Close, Volume — standard candlestick data format used in price charts. Each candle represents a fixed time period.
resolutionTime bucket size for candlestick data. Options: 1m, 5m, 15m, 1h, 4h, 1d. Smaller resolution = more granular data.
General
slugURL-friendly identifier for a market. Example: "will-bitcoin-hit-100k-by-2026". Used for lookups and search queries.
event_slugSlug identifying the parent event that groups related markets together. One event (e.g., "2024 US Election") can contain many markets.
outcomeA possible result of a prediction market. Binary markets have "Yes"/"No" outcomes. Multi-outcome markets can have many (e.g., candidate names).
Integration
MCPModel Context Protocol — an open standard for connecting AI models to external data sources. Heisenberg supports MCP for Claude integration.