Natural-language search across Polymarket events, markets, and tags.

The primary entry point for "find me markets about X". Each returned event includes a short list of its markets with parsed outcomes and probabilities.

Args: query: Free text, e.g. "2024 election" or "bitcoin 100k". limit_per_type: Max results per type (events/tags), capped at 20. events_status: Optional status filter, e.g. "active". keep_closed_markets: Include closed markets in results (default False).

Browse and filter markets. Defaults to active, open markets by 24h volume.

Args: active: Best-effort active filter (Gamma honors it though it's under-documented). closed: Include resolved/closed markets (default False). tag_id: Single numeric tag id to filter by. order: Sort field, e.g. "volume24hr", "liquidity_num", "volume_num", "endDate". ascending: Sort ascending (default False = highest first). volume_num_min: Minimum total volume (note the _num_ infix for markets). liquidity_num_min: Minimum liquidity. start_date_min/start_date_max/end_date_min/end_date_max: ISO-8601 bounds. limit: 1-100 (default 20). offset: paging offset.

Resolve one market in full detail by id, slug, OR condition_id (provide one).

Args: id: Numeric Gamma market id (e.g. "507034"). A "0x..." value is treated as a condition id. slug: Market slug (e.g. "will-trump-win-the-2024-us-presidential-election"). condition_id: On-chain condition id ("0x...").

Browse and filter events (groups of related markets). Same shape as list_markets.

Note: events use volume_min/liquidity_min (NOT the _num_ infix that markets use).

Event detail with all child markets (parsed outcomes/prices/tokenIds).

Useful for multi-candidate / neg-risk events. Provide an id or a slug.

What's hot right now: active, open markets sorted by 24h volume (descending).

Freshest live odds for one outcome token from the CLOB.

token_id is a CLOB token id (one of a market's clobTokenIds) — NOT a slug or conditionId. Returns midpoint, best bid/ask, spread, and probability_pct. These are fresher than Gamma's cached prices.

Live order book for one outcome token: best bid/ask, midpoint, spread, top levels.

token_id is a CLOB token id. depth caps the number of price levels per side (default 10, max 50). Level prices/sizes are parsed to floats.

Historical probability time-series for one outcome token.

token_id is a CLOB token id (it maps to the misleadingly-named market param).

Args: interval: One of "1h", "6h", "1d", "1w", "1m" (1 month), "max", "all". Ignored when an explicit start_ts/end_ts range is given. fidelity: Resolution in minutes. Defaults to a safe value per interval (wider ranges require a higher minimum). start_ts/end_ts: Optional unix-second bounds (override interval).

Long series are downsampled to <=500 points (flagged in the result).

Public current holdings for a wallet address (0x...).

Args: wallet: EVM address, e.g. "0x...". limit: 1-100 (default 20). sort_by: One of CURRENT, CASHPNL, PERCENTPNL, TOKENS, INITIAL, PRICE, AVGPRICE, TITLE, RESOLVING (default CURRENT). Sorted descending.

Recent on-chain activity (trades, splits, merges, redeems...) for a wallet.

Args: wallet: EVM address (0x...). limit: 1-100 (default 20). type: Optional activity type, e.g. "TRADE", "SPLIT", "MERGE", "REDEEM", "REWARD".

Top holders per outcome token for a market.

Args: condition_id: The market's on-chain condition id ("0x..."). (Maps to the Data API's market param.) limit: Top-N holders per token, capped at 20 by the API.

Total current value (USDC) of a wallet's Polymarket positions.

Args: wallet: EVM address (0x...).

Live odds for one market in a single call (the recommended starting point).

Resolves a market (by slug, or by searching free text and picking the most liquid match), then fetches the freshest CLOB midpoint for each outcome token. Gamma's cached price can lag the live book — live_midpoint is the freshest value.

Provide a slug (preferred) or a free-text query.