Grok-powered AI analysis of Polymarket and Kalshi prediction markets, paid per call in USDC on Base via x402.
What it does
PolyNews Intelligence API provides real-time prediction market data and AI-driven analysis for Polymarket and Kalshi markets. The `/api/v1/market-context` endpoint is the flagship premium call: given a market ID and question, it returns a Grok-generated analysis covering breaking news, background context, forward-looking signals, sentiment classification (bullish/bearish/neutral), and cited sources from both news outlets and X (Twitter). It costs $0.05 per call in USDC on Base, settled via the x402 micropayment protocol with no API key or subscription required.
The broader API suite spans 16 endpoints across four pricing tiers. Free endpoints expose active markets, live prices, health checks, and documentation. Standard-tier endpoints ($0.001–$0.005) deliver real-time trade feeds (rolling 2-hour window, $500+ trades), historical price time-series, and market structure metadata. Premium-tier endpoints ($0.05–$0.08) use Grok AI for market context analysis, price-movement catalyst identification, news/X context retrieval around specific timestamps, and daily multi-market briefings. Alpha-tier endpoints ($0.01–$0.10) cover cross-platform Polymarket × Kalshi arbitrage detection, smart money signal detection, wallet performance scoring (sharp score, badges, ROI, P&L), and discounted combo endpoints that bundle AI analysis with smart money data in parallel.
All paid endpoints follow the x402 protocol: the server returns HTTP 402 with payment requirements in the WWW-Authenticate header, the client pays USDC on Base via the x402.org facilitator, then retries with an X-Payment proof header. The receiver address is 0x6ee49a7872844397Fb52870Cc07b308fFADC9427. A full OpenAPI 3.1 spec and JSON documentation endpoint are available for agent discovery.
Capabilities
Use cases
- —Autonomous trading agents querying AI-generated context before placing Polymarket bets
- —Detecting cross-platform arbitrage opportunities between Polymarket and Kalshi
- —Monitoring smart money wallet activity and insider signals on specific prediction markets
- —Generating daily briefings across a watchlist of prediction markets
- —Investigating what news or X posts caused a specific price movement in a market
Fit
Best for
- —AI trading agents that need real-time prediction market intelligence with pay-per-call pricing
- —Developers building prediction market dashboards or alert systems
- —Researchers analyzing smart money behavior and wallet performance on Polymarket
- —Agents that need cited, source-backed analysis rather than raw price data
Not for
- —Historical backtesting requiring bulk data downloads (per-call pricing adds up)
- —Non-prediction-market financial data (stocks, forex, commodities)
- —Users without a crypto wallet or USDC on Base for payment
Quick start
from x402_client import X402Client
client = X402Client(wallet_key="YOUR_KEY", network="base")
resp = client.post(
"https://polynews.news/api/v1/market-context",
json={
"marketId": "69317",
"marketQuestion": "Democratic Presidential Nominee 2028",
"marketOdds": "Gavin Newsom: 27%"
}
)
print(resp.json()["analysis"])Example
Request
{
"marketId": "69317",
"marketOdds": "Gavin Newsom: 27%",
"marketQuestion": "Democratic Presidential Nominee 2028"
}Response
{
"data": {
"sources": [
{
"url": "https://example.com/newsom-poll",
"type": "news",
"title": "Newsom leads 2028 Democratic field in new poll"
},
{
"url": "https://x.com/politico/status/123456",
"type": "x",
"title": "@politico: Newsom's Asia trip signals 2028 ambitions"
}
],
"analysis": "Gavin Newsom leads the Democratic 2028 primary field at 27%, buoyed by recent polling and national media appearances. Key developments include his trade delegation to Asia and rising favorability among younger voters. AOC at 8% represents a progressive lane that could consolidate if Newsom stumbles. Forward signals: watch for early endorsement announcements and Q3 fundraising numbers.",
"sentiment": "bullish",
"confidence": "medium"
}
}Endpoint
Quality
Full OpenAPI 3.1 spec with detailed schemas for all 16 endpoints, clear per-call pricing, live 402 challenge captured and matching the documented price ($0.05 = 50000 base units USDC), comprehensive docs page, and example request/response shapes. Minor deduction because actual successful response bodies are not captured (only schema), and no agents.txt is present.
Warnings
- —Response examples are inferred from schema; no actual paid response was captured during probing.
- —The API provides AI-generated market analysis and sentiment — this is not financial advice and should not be treated as such.
Citations
- —The /api/v1/market-context endpoint costs $0.05 per call in USDC on Basehttps://polynews.news/docs
- —The x402 challenge returns maxAmountRequired of 50000 (= $0.05 USDC with 6 decimals) for market-contexthttps://polynews.news/api/v1/market-context
- —The API has 16 endpoints across four pricing tiers: Free, Standard ($0.001–$0.005), Premium ($0.05–$0.08), and Alpha ($0.01–$0.10)https://polynews.news/docs
- —USDC receiver address is 0x6ee49a7872844397Fb52870Cc07b308fFADC9427 on Basehttps://polynews.news/docs
- —Cross-platform arbitrage detection covers Polymarket and Kalshihttps://polynews.news/openapi.json
- —Smart money detection includes suspicious wallet analysis, notable holder positions, and insider signalshttps://polynews.news/openapi.json
- —Wallet scoring provides sharp score (0–100), badges, ROI, and P&L metricshttps://polynews.news/openapi.json
- —The feed endpoint returns trades from a 2-hour rolling window with $500+ minimum trade valuehttps://polynews.news/openapi.json