Search Polymarket US events by text. Returns compact event + market summaries with current best bid/ask so you can pick a market slug for deeper tools.

List events with filters and pagination. Each event includes its markets with best bid/ask and implied probability. Use offset to page.

Get one event with all of its markets, rules excerpt, tags, and quotes.

List markets directly (flat, not grouped by event). For an event's markets prefer pmus_get_event — the gateway's eventSlug filter is unreliable.

Get one market: rules/settlement text, tick size, fee coefficient, sides, quotes.

Best bid/offer snapshot: bid, ask, last trade, depth counts, open interest, long/short display quotes, and market state.

Order book (bids and offers, best first) with per-level price and quantity, cumulative size, and market stats.

Settlement result for a closed market (1 = YES, 0 = NO, 0.5 = void/50-50). Returns settled=false if the market has not settled yet.

Historical long (YES, from best ask) and short (NO, from 1 - best bid) prices. Note: the gateway currently returns empty history for many markets.

List series (recurring groupings like 'nfl-2025', 'fed', 'us-midterms-2026').

List sports/leagues supported by Polymarket US with their tag and series ids.

List tags, or fetch one tag with its subtags. Tag slugs feed pmus_list_events(tag_slug=...).

Full spread + fee + payoff breakdown for one market: bid/ask/mid, spread in ticks, taker vs maker economics for long-YES and short-NO, breakeven probabilities, annualized ROI to end date, inside-spread resting-order ladder, depth near the touch, and (optionally) execution simulation for a given size.

Scan active markets for extreme implied probabilities (heavy favorites >= high_threshold and long shots <= low_threshold). For each, computes the fee-adjusted 'yield to settlement' of betting WITH the market (buy YES on favorites, short NO on long shots), annualized to the end date, plus spread width and whether resting inside the spread beats crossing. Uses event snapshot quotes; confirm with pmus_analyze_spread before acting.

Price the whole outcome set of an event: sum of asks and bids after fees, the overround, and the locked P&L from buying every YES or shorting every market IF the outcomes are mutually exclusive. Surfaces mispricing across a spread family.

Check an event's spread and total ladders for impossible pricing. A harder line can never be more likely than an easier one (win by 3+ <= win by 2+, over 10.5 <= over 9.5, underdog +1.5 <= +2.5). When the harder line's bid is above the easier line's ask, buying the easier line and shorting the harder one locks in profit after taker fees. Reports locked P&L per pair, the size available at the touch on both legs, and label conflicts (question vs rules text) on spread markets.