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 analysis: ranked news + X citations with a structured developments/context/what-to-watch summary
/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 briefing across markets you supply (no watchlist needed): headline, key developments, sentiment
/api/v1/election-forecastGrok consensus election forecast: per-candidate market+poll blend with the averaged polls, for candidate/party winner markets
/api/v1/walletWallet scoring: sharp score, trader badge, top trades, calibration metrics (alpha/Brier/conviction)
/api/v1/smart-moneySmart money detection: suspicious wallets, top YES/NO holders, sentiment, insider signal counts, trade recommendation
/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 or Solana — no API key needed
client = X402Client(wallet_key="YOUR_PRIVATE_KEY", network="base") # or Solana signer
# 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
Every paid endpoint accepts USDC on Base or Solana mainnet. The 402 response includes an accepts[] array with one entry per network — your client picks either option and pays the same price.
Request endpoint
Your agent calls any paid endpoint. The server returns HTTP 402 with payment requirements in the PAYMENT-REQUIRED header (v2) or response body (v1 compat).
Submit USDC payment
The x402 client signs and settles USDC on your chosen network — Base (EIP-3009) or Solana (SPL USDC) — via the CDP facilitator. Register the matching scheme/signer for the accepts[] entry you select.
Retry with proof
The client retries the original request with the PAYMENT-SIGNATURE header (X-Payment alias supported). The server verifies settlement and returns the data.
Base · USDC receiver
0x6ee49a7872844397Fb52870Cc07b308fFADC9427
Solana · USDC receiver
76xzzgua9K8985GqGMwB946zTFtHvjTd9MfGoTYfys3d
Payment Networks
Agents can discover live network IDs, receiver addresses, and the facilitator URL from a free JSON endpoint — no payment required. It is also linked from /.well-known/x402.json and the OpenAPI spec.
curl https://polynews.news/api/v1/supported-networks | jq '{
multiNetwork,
chains: [.networks[].chain],
networks: [.networks[] | {chain, network, receiver}]
}'