{"uid":"cap_PFQ2VDKr4tHeJHAsMjXIO","slug":"polynews-news-b0e9fb35","name":"polynews.news Move Context — Price Movement News & X Post Search","description":"Search for news and X posts around a specific price movement timestamp","url":"https://polynews.news/api/v1/move-context","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"date":{"type":"string"},"type":{"type":"string","description":"'news' or 'x_post'"},"title":{"type":"string"},"source":{"type":"string"},"snippet":{"type":"string"}}},"description":"News + X posts (use type to distinguish), most relevant first"},"searchWindow":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"}}},"moveTimestamp":{"type":"number"}}}}}}}}},"responseSchema":{"type":"json","example":{"data":{"news":[{"url":"https://reuters.com/...","title":"Reuters: Newsom advisor joins 2028 exploratory committee","relevance":0.94,"publishedAt":"2026-05-12T18:23:00Z"},{"url":"https://politico.com/...","title":"Politico polling update — California internals shift","relevance":0.81,"publishedAt":"2026-05-12T19:01:00Z"}],"xPosts":[{"text":"Big move on Newsom 2028 — Reuters wire just dropped","likes":2400,"author":"@nate_cohn","postedAt":"2026-05-12T18:25:00Z"}],"windowHours":24,"moveTimestamp":1740003600000},"meta":{"tier":"premium","version":"v1","endpoint":"/api/v1/move-context","latencyMs":16700,"timestamp":"2026-05-12T04:30:00.000Z"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_E04GdgKKMrx97t3EYPu3X","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches for relevant news articles and X posts surrounding a specific price movement timestamp on a prediction market","exampleAgentPrompt":"Can you pull the news and X posts that were circulating around the time of this Polymarket price spike — the market ID is 'will-trump-win-2024' and it moved sharply on November 6th, 2024 at 2:15 AM UTC?","exampleUseCases":[{"title":"Explain sudden prediction market spike","prompt":"There was a big price jump on the 'will-fed-cut-rates-q1-2025' Polymarket around March 12th, 2025 at 3:40 PM UTC — can you find the news articles and X posts from that time that might explain what caused it?"},{"title":"Find catalyst for market price drop","prompt":"The 'will-ukraine-ceasefire-2025' prediction market dropped sharply on February 8th, 2025 at 9:15 AM UTC. Can you dig up any news or tweets that were circulating right around that timestamp to figure out what triggered the sell-off?"},{"title":"Research social media around market move","prompt":"I'm analyzing a trade I made on Polymarket for the 'bitcoin-100k-2025' market — it moved hard on January 20th, 2025 at 6:50 AM UTC and I want to understand why. Can you pull the relevant news and X posts from right around that moment?"}],"resultDescription":"Returns a curated set of news articles and X (Twitter) posts published near the specified price movement timestamp, providing context for what likely caused or accompanied the market movement. Results include source citations and publication times relevant to the price event.","failureModes":["Invalid or missing timestamp returns 400 error","Unknown market ID returns empty results or 404","No news or X posts found near the timestamp returns empty result set","Grok API downstream failure causes 503 or timeout","Rate limiting or payment failure returns 402 or 429"],"whenToPreferThis":"Use this endpoint when you need to understand the specific news or social media catalyst behind a discrete price movement at a known timestamp on a prediction market. Prefer this over the general market-context endpoint when you already know the exact timestamp of the move and want targeted, time-anchored content rather than a broader market briefing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:36:49.721Z","isFirstParty":false}