{"uid":"cap_ZtJ9yCBgU_VYuuhBycejT","slug":"bookproof-fee-aware-polymarket-execution-quote-e1e274d1","name":"Bookproof — Fee-aware Polymarket Execution Quote","description":"Read-only Polymarket depth, spread, fee, freshness, and executable VWAP data for autonomous agents, paid per call with x402.","url":"https://bookproof-api.sn95wjq846.chatgpt.site/api/v1/execution-quote","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"market":{"type":"string","maxLength":500,"minLength":2,"description":"Polymarket URL, market slug, CLOB token ID, or market search phrase."},"outcome":{"type":"string","description":"One of the market's two exact outcome labels, case-insensitive."},"budgetUsd":{"type":"number","maximum":10000,"minimum":1,"description":"Maximum all-in USD budget, including modeled taker fees."}}},"responseSchema":{"type":"json","example":{"quote":{"rawCostUsd":97.83,"takerFeeUsd":2.17,"allInCostUsd":100,"filledShares":219.78022,"priceImpactBps":348.84,"averageFillPrice":0.445},"market":{"slug":"will-the-fed-decrease-interest-rates-by-25-bps-after-the-july-2026-meeting"},"request":{"action":"buy","outcome":"Yes","budgetUsd":100},"service":"bookproof"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZQkK5YcyyLQhhceSc_oXP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns read-only Polymarket order book depth, spread, taker fees, and VWAP-based execution quote for a given market outcome and USD budget","exampleAgentPrompt":"What's the all-in cost and price impact if I spend $100 buying Yes on the will-the-Fed-decrease-interest-rates-by-25-bps-after-the-July-2026-meeting market on Polymarket, including taker fees?","exampleUseCases":[{"title":"Pre-trade slippage check for large position","prompt":"Before I commit $2000 to buying Yes on the 2026 US recession market on Polymarket, can you tell me how many shares I'd get, what the average fill price would be, and how many basis points of price impact I'm looking at?"},{"title":"Fee budgeting for autonomous trading agent","prompt":"I'm building a bot that trades Polymarket. Can you pull the taker fee and all-in cost breakdown for a $500 No buy on the 'Will Bitcoin hit $150k by end of 2025?' market so I can decide if the trade is still worth it after fees?"},{"title":"Comparing execution cost across two outcomes","prompt":"For the 'Will the S&P 500 close above 6000 by December 2025?' Polymarket market, give me an execution quote for buying $300 of Yes — I want to see the fill price, shares received, and total cost including fees."}],"resultDescription":"A JSON object containing the quote (raw cost in USD, taker fee in USD, all-in cost in USD, number of shares filled, price impact in basis points, average fill price), the resolved market slug, and a mirror of the request parameters. All figures are pre-trade estimates derived from live order book depth — no trade is executed.","failureModes":["Market not found: ambiguous slug or phrase returns an error if no match can be resolved","Outcome label mismatch: providing an outcome string that does not match the market's exact labels causes rejection","Budget out of range: budgetUsd below $1 or above $10,000 returns a validation error","Insufficient liquidity: if order book depth is too shallow to fill the budget, the quote may be partial or return an error","Stale book data: if the Polymarket CLOB feed is delayed, freshness indicators may signal degraded data quality","Service unavailable: the paid x402 endpoint may return 402 if payment is not properly included"],"whenToPreferThis":"Choose this endpoint when you need a precise, fee-inclusive execution quote for a specific Polymarket outcome before placing a trade — especially when price impact, taker fees, and VWAP accuracy matter. It is purpose-built for autonomous agents doing pre-trade analysis on Polymarket and is superior to raw CLOB API calls because it models fees, computes VWAP, and packages everything in a single structured response. Prefer it over generic prediction market data APIs when you need actionable cost estimates rather than just current prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:38:01.934Z","isFirstParty":false}