Discover tradeable Polymarket markets of ANY kind (politics, sports, crypto, culture). With a query, full-text search; without, the most active events by 24h volume. Returns event title plus, per market, the slug to pass to the market tool and the outcome names.

All binary markets of one multi-outcome EVENT (an election, a tournament: one market per candidate). Use the event slug from find_markets. Returns per market: slug, outcome names with token ids, close time, settled winner if any.

Resolve one Polymarket market by its gamma slug (any category, works for expired short-lived markets too). Returns condition_id, the outcome names mapped to their token ids (use those token ids with book and the trading tools), the close time and the settled winner if resolution already happened.

One read-only decision snapshot: resolve a market and return the live top-of-book summary for each outcome. This does not place or prepare an order, and a missing book is reported only for that outcome.

REAL-TIME order book summary for one outcome token: best bid/ask with sizes, plus the $ notional of asks resting inside [depth_lo, depth_hi]. This endpoint is served by the matching engine; trust it over the trade tape for any live decision.

Read-only top-of-book FAK preview. For BUY, amount is USD and price_limit is the highest acceptable price. For SELL, amount is shares and price_limit is the lowest acceptable price. It never creates an executor, sends an order, or reserves budget. Fees are an estimate using the documented crypto-table rate until the exchange confirms a fill.

Official Polymarket taker fee in $ (fee = rate * p * (1-p) * shares). Categories and rates: crypto 0.07, sports 0.03, finance/politics/mentions/ tech 0.04, economics/culture/weather 0.05, geopolitics 0. Makers pay 0.

Operator-visible mode and safety-rail status. This is keyless: it never constructs a signer, checks a live balance, or changes state.

Collateral (pUSD, $) the CLOB sees for the configured account. If this is 0 while funds are on-chain, the operator's POLY_SIG_TYPE is wrong (the Polymarket app's deposit wallet needs 3). In paper mode: the simulated cash balance.

BUY-side totals of OUR account on one market: (shares, usd, fee_estimate), usd and fees counting BUY fills only. This is the reconciliation source, use it after any uncertainty instead of trusting local bookkeeping. Paper mode: same semantics over the simulated fills, except shares are net of paper sells (position, not gross buys).

Current portfolio without placing an order. Paper mode returns the local durable ledger. Otherwise pass a public wallet address, or configure POLY_FUNDER, to read its public Data API positions. Data API values lag the matching engine and are not exchange reconciliation truth.