--- name: bookproof-api.sn95wjq846.chatgpt.site description: bookproof-api.sn95wjq846.chatgpt.site provides read-only order-book intelligence for Polymarket binary prediction markets. It exposes two skills: one for fetching a market health snapshot (liquidity depth, spread, fees) and one for modeling a BUY execution quote against live order-book asks without placing any real order. host: bookproof-api.sn95wjq846.chatgpt.site --- # bookproof-api.sn95wjq846.chatgpt.site This host serves agents that need pre-trade analysis on Polymarket binary markets. It covers two complementary read-only operations: assessing whether a market's order book is healthy enough to trade (spread, depth, stale/crossed status) and estimating the cost and share yield of a hypothetical BUY order given a USD budget. It does not execute trades, support SELL-side quoting, or provide streaming data. ## When to use this host Use this host when an agent needs read-only pre-trade intelligence on a specific Polymarket binary market — either to assess order-book health or to model the cost of a BUY order. Do not use it to execute or submit actual trades; a separate execution endpoint or Polymarket's own trading API is required for that. Do not use it for SELL-side quote modeling, as only BUY quotes are supported. Do not use it for continuous or streaming price monitoring; both skills return single-shot snapshots and are not designed for polling loops. If you need broader prediction market coverage beyond Polymarket binary markets, this host is not appropriate. ## Capabilities ### Order Book Health Assessment Retrieves a point-in-time snapshot of a Polymarket binary market's liquidity, spread, depth bands, imbalance, and fee schedule to determine whether conditions are suitable for trading. - **`fetch-polymarket-market-health`** — Returns per-outcome best bid/ask, spread, depth at 1/2/5 cent bands, two-cent imbalance, snapshot age, and taker fee model for a Polymarket binary market identified by slug. ### Pre-Trade BUY Quote Modeling Sweeps the current ask side of a market's order book for a specific outcome and returns modeled fill details — shares received, VWAP, price impact, taker fee, and unfilled budget — without committing to any real trade. - **`fetch-execution-quote`** — Sweeps the current order book asks for a prediction market outcome and returns modeled filled shares, VWAP, price impact, taker fee, and any unfilled budget without placing an order. ## Workflows ### Pre-Trade Health Check Then Quote *Use when an agent needs to verify a market is liquid and not stale before modeling a BUY order, to avoid quoting into a crossed or thin book.* 1. **`fetch-polymarket-market-health`** — Fetch the order-book health snapshot for the target market slug to confirm spread is acceptable, depth is sufficient, and the book is not stale or crossed. 2. **`fetch-execution-quote`** — If health conditions pass, model the BUY execution quote for the desired outcome and USD budget to estimate shares, VWAP, price impact, and fees before any real trade decision. ## Skill reference ### `fetch-execution-quote` **Execution Quote (BUY)** — Sweeps the current order book asks for a prediction market outcome and returns modeled filled shares, VWAP, price impact, taker fee, and any unfilled budget without placing an order. *Use when:* Use when an agent needs to estimate the cost and share yield of a BUY order on a prediction market outcome given a USD budget, before committing to any real trade. *Not for:* Do not use to place or execute an actual order; this is a read-only indicative quote. Do not use for SELL-side quotes or for streaming price feeds. **Inputs:** - `slug` (string, required) — URL slug identifying the prediction market (2–200 chars). - `outcome` (string, required) — The outcome side to quote a BUY for (1–80 chars), e.g. 'Yes' or 'No'. - `budgetUsd` (number, required) — All-in USD budget to model against the order book (1–10000). **Returns:** Returns a quote object with filledShares (23814), allInCostUsd (100), takerFeeUsd (4.74), priceImpactBps (0), and a fills array, plus market metadata and a 5-second expiry timestamp. **Example:** `{"slug":"will-the-fed-decrease-interest-rates-by-25-bps-after-the-july-2026-meeting","outcome":"Yes","budgetUsd":100}` --- ### `fetch-polymarket-market-health` **Polymarket Market Health Snapshot** — Returns per-outcome best bid/ask, spread, depth at 1/2/5 cent bands, two-cent imbalance, snapshot age, and taker fee model for a Polymarket binary market identified by slug. *Use when:* Use when an agent needs a current order-book health snapshot for a specific Polymarket binary market — including liquidity depth, spread, stale/crossed status, and fee schedule — before deciding to quote or trade. *Not for:* Do not use to execute or simulate a trade; use a quote or execution endpoint instead. Not suitable for streaming or continuous price feeds — this is a single-shot snapshot. **Inputs:** - `slug` (string, required) — Polymarket market slug identifying the binary market to inspect. Must be 2–200 characters. **Returns:** Returns a MarketHealth object with market metadata, health flags (status, stale, crossed), taker fee schedule, and a books array containing best bid/ask, spread, depth at 1/2/5 cent bands, and imbalance for each binary outcome. **Example:** `GET https://bookproof-api.sn95wjq846.chatgpt.site/api/v1/market-health?slug=will-the-fed-decrease-interest-rates-by-25-bps-after-the-july-2026-meeting` ---