Search news articles and X posts around a prediction market price movement timestamp via Grok AI.
What it does
The `/api/v1/move-context` endpoint on the PolyNews Intelligence API searches for news articles and X (Twitter) posts within a configurable time window around a specific price movement timestamp on Polymarket. It accepts a market question, a Unix timestamp of the price movement, and an optional `windowHours` parameter (default 24 hours) to control the search range. The response returns an array of items including news articles and X posts with titles, URLs, types, and publication timestamps. This endpoint is designed as a precursor to the `/api/v1/analyze-move` endpoint, which uses the gathered context to perform Grok-powered catalyst analysis.
The endpoint is part of the broader PolyNews API suite, which provides real-time Polymarket and Kalshi prediction market intelligence for autonomous trading agents. It costs $0.05 USDC per call, paid on Base via the x402 micropayment protocol — no API keys or subscriptions required. The USDC receiver address is `0x6ee49a7872844397Fb52870Cc07b308fFADC9427`. The full API includes 16 endpoints across four pricing tiers: free market discovery, standard data feeds ($0.001–$0.005), premium Grok AI analysis ($0.05–$0.08), and alpha-tier smart money/arbitrage endpoints ($0.01–$0.10).
The endpoint returned a valid HTTP 402 x402 challenge during probing, confirming it is live. The OpenAPI 3.1 spec provides full request/response schemas, and the docs page lists all endpoints with pricing and quick-start code examples in Python and curl.
Capabilities
Use cases
- —Gather news and social media context around a sudden Polymarket price spike or drop before running catalyst analysis
- —Build automated trading agent pipelines that detect price movements, fetch context, then analyze catalysts
- —Monitor prediction market events by correlating price changes with real-world news in a configurable time window
- —Feed contextual news data into downstream AI analysis for prediction market trading decisions
- —Audit historical price movements by retrieving what news and X posts were published around the time of the move
Fit
Best for
- —Autonomous prediction market trading agents needing contextual news around price movements
- —Developers building Polymarket analysis pipelines with x402 micropayments
- —Researchers correlating prediction market price changes with news events
- —AI agents that chain move-context → analyze-move for end-to-end catalyst identification
Not for
- —General-purpose news search unrelated to prediction markets
- —Users who need free unlimited API access (this endpoint costs $0.05 per call)
- —Real-time streaming news feeds (this is a point-in-time search around a timestamp)
Quick start
curl -X POST https://polynews.news/api/v1/move-context \
-H "Content-Type: application/json" \
-H "X-Payment: <x402-payment-proof>" \
-d '{"marketQuestion": "Democratic Presidential Nominee 2028", "moveTimestamp": 1740003600000, "windowHours": 24}'Example
Request
{
"windowHours": 24,
"moveTimestamp": 1740003600000,
"marketQuestion": "Democratic Presidential Nominee 2028"
}Response
{
"data": {
"news": [
{
"url": "https://example.com/article-1",
"type": "news",
"title": "Newsom surges in 2028 Democratic primary polls",
"publishedAt": "2025-02-19T21:00:00Z"
}
],
"xPosts": [
{
"url": "https://x.com/politico/status/123456",
"type": "x",
"title": "@politico: Breaking — Newsom announces exploratory committee",
"publishedAt": "2025-02-19T20:30:00Z"
}
]
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with request/response definitions, live 402 challenge confirmed, clear pricing ($0.05 USDC on Base), docs page with quick-start examples. Slightly below 0.9 because no real example response body was captured (only the 402 challenge), so the response shape is inferred from the schema and outputSchema.
Warnings
- —Example response is inferred from the OpenAPI schema and x402 outputSchema — no actual 200 response was captured during probing.
- —The outputSchema in the x402 challenge shows a slightly different response shape (data.news, data.xPosts) than the OpenAPI spec (items array), suggesting possible schema inconsistency.
Citations
- —The /api/v1/move-context endpoint costs $0.05 USDC per callhttps://polynews.news/docs
- —The endpoint searches for news and X posts in a configurable time window around a price movement timestamphttps://polynews.news/docs
- —USDC receiver address is 0x6ee49a7872844397Fb52870Cc07b308fFADC9427 on Basehttps://polynews.news/docs
- —The endpoint is designed to be used before /api/v1/analyze-move for catalyst analysishttps://polynews.news/docs
- —The x402 challenge returned maxAmountRequired of 50000 (i.e. $0.05 USDC with 6 decimals) confirming the endpoint is livehttps://polynews.news/api/v1/move-context
- —The API has four pricing tiers: free, standard ($0.001–$0.005), premium ($0.05–$0.08), and alpha ($0.01–$0.10)https://polynews.news/docs