Documentation
Introduction
The Scanna REST API — base URL, authentication, and what it covers.
The Scanna REST API is the core surface for prediction market intelligence. It serves trending markets, ML predictions, smart money, cross-venue divergence, analytics, and raw market data over HTTP — the same data that powers the MCP server and the SDKs.
Base URL: https://api.scanna.xyz
Every endpoint requires an API key except /health — see
Authentication.
Get a key (free, no card required).
curl -H "x-api-key: YOUR_KEY" "https://api.scanna.xyz/hot?limit=5"In this section
Authentication
API key header precedence and error responses.
Rate Limits
Per-key limits and 429 behavior.
Signals
Trending markets, market heat, smart money, health, and metrics.
Market Data
Markets, prices, books, trades, wallets, and leaderboards.
Analytics
Risk score, arbitrage, signals, insider score, clusters (Pro).
AI Predictions
Resolved and live ML predictions, plus model details (Pro).
Cross-Venue Divergence
Price gaps for the same event across Polymarket and Kalshi.
Training Data Export
Labeled, time-sliced features as CSV or JSON (Pro).
Integration Examples
Drop-in Python, TypeScript, and LLM agent examples.