PolyNews API for Agents
Real-time Polymarket + Kalshi intelligence. No API keys. No subscriptions. Autonomous agents pay $0.001–$0.10 USDC per call via x402.
Pricing Tiers
$0.00
Market discovery, live prices, health checks, and API documentation
$0.001–$0.005
Real-time trade feeds, price history, and market structure data
$0.05–$0.08
Grok AI analysis: news context, price catalyst analysis, daily briefings
$0.01–$0.10
Arbitrage detection, smart money signals, wallet scoring, and combo endpoints
Endpoints
/api/v1/price-historyHistorical price data with configurable timeframes (1H/6H/1D/1W/1M/ALL)
/api/v1/market-infoMarket structure metadata: type detection, outcomes with probabilities
/api/v1/market-contextGrok-powered AI analysis: breaking news, background context, X sentiment, source citations
/api/v1/analyze-moveGrok-powered price movement catalyst analysis with confidence scoring
/api/v1/move-contextSearch for news and X posts around a specific price movement timestamp
/api/v1/morning-briefingDaily Grok market briefing across your watchlist: headline, sentiment, signals
/api/v1/walletWallet performance scoring: sharp score, badges, top trades, P&L metrics
/api/v1/smart-moneySmart money detection: suspicious wallets, insider signals, trade recommendations
/api/v1/market-deepCOMBO: Grok analysis + smart money in one parallel call (10% cheaper)
Quick Start
import httpx
from x402_client import X402Client # pip install x402-client
# Auto-pays USDC on Base — no API key needed
client = X402Client(wallet_key="YOUR_PRIVATE_KEY", network="base")
# Free: get all active markets
markets = client.get("https://polynews.news/api/v1/markets").json()
iphone = next(m for m in markets["markets"] if "iPhone 18" in m["question"])
# Premium ($0.05): Grok AI analysis
analysis = client.post(
"https://polynews.news/api/v1/market-context",
json={
"marketId": iphone["id"],
"marketQuestion": iphone["question"],
"marketOdds": "Yes: 72%",
}
).json()
print(analysis["analysis"])
# Alpha ($0.01): cross-platform arbitrage
arb = client.get(
"https://polynews.news/api/v1/arbitrage",
params={"category": "tech", "minSpread": "0.02"}
).json()
print(arb["opportunities"])How x402 Micropayments Work
Request endpoint
Your agent calls any paid endpoint. The server returns HTTP 402 with payment requirements in the WWW-Authenticate header.
Submit USDC payment
The x402 client library pays the required USDC amount on Base via the facilitator (x402.org). Your wallet is charged automatically.
Retry with proof
The client retries the original request with the X-Payment header containing payment proof. The server verifies and returns the data.
USDC Receiver on Base
0x6ee49a7872844397Fb52870Cc07b308fFADC9427