{"uid":"cap_Q9CGsvQiIj_GGXk9dQHAY","slug":"liquid-agent-polymarket-btc-15m-price-to-beat-3da35562","name":"Liquid Agent: Polymarket BTC 15m Price to Beat","description":"Polymarket BTC 15m Up/Down in one call: the OFFICIAL price to beat (the 60 s Chainlink TWAP before the window, matched to the cent against Polymarket's results), the live Chainlink price and its distance from the price to beat, seconds left, token ids and the market's own prices. ?start=<unix> returns a past window's official settle and outcome. $0.002 USDC. Data, not financial advice.","url":"https://api.liquidagent.ai/v1/polymarket/btc-15m?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"market":{"slug":"btc-updown-15m-1790652300","asset":"BTC","timeframe":"15m","secondsLeft":120},"status":"live","distance":55.93,"chainlink":{"price":83140.29},"priceToBeat":83084.36,"marketPrices":{"up":0.925,"down":0.075}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o1bfTOiWBkRul7AMi2B0L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the official Polymarket BTC 15-minute Up/Down market data including the Chainlink TWAP price to beat, live BTC price, distance from target, time remaining, and current market token prices.","exampleAgentPrompt":"What's the current BTC price to beat on the Polymarket 15-minute Up/Down market right now — show me the Chainlink TWAP reference price, the live BTC price, how far away it is, and how many seconds are left in the window.","exampleUseCases":[{"title":"Live BTC market position check","prompt":"What's the BTC price to beat on the Polymarket 15m market right now, and is the live Chainlink price above or below it?"},{"title":"Historical window settlement lookup","prompt":"What was the official settlement price and outcome for the BTC 15-minute Polymarket window that started at Unix timestamp 1790652300?"},{"title":"Automated prediction market signal bot","prompt":"Keep checking the Polymarket BTC 15m market for me — tell me whenever the live price is within $50 of the price to beat and show me the current up/down token prices."}],"resultDescription":"A JSON object containing: market metadata (slug, asset, timeframe, seconds remaining), current status (live/settled), the official Chainlink TWAP price to beat, the live Chainlink BTC price, the dollar distance between live price and price to beat, and the current Polymarket up/down token prices. For historical queries (via ?start= parameter), includes the settled outcome and official settlement price.","failureModes":["Invalid or future unix timestamp in ?start= parameter returns an error","Market not yet created or window not started may return empty/null data","Chainlink oracle delay may cause brief gaps in live price data","Network or provider downtime can return 5xx errors","Malformed request parameters may result in 400 bad request"],"whenToPreferThis":"Use this endpoint when you need the authoritative Polymarket BTC 15-minute Up/Down settlement reference price (the 60-second Chainlink TWAP) alongside live price data in a single call. It is the canonical source for the exact price Polymarket uses for settlement, matched to the cent, making it ideal for prediction market trading agents, signal bots, and post-hoc settlement verification. Prefer it over generic price feeds when you need the Polymarket-specific reference price rather than just live spot price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:44:25.055Z","isFirstParty":false,"canonicalSlug":"liquid-agent-polymarket-btc-15m-price-to-beat-3da35562"}