📄️ Overview
What the aggregator is — eight third-party prediction-market platforms (Kalshi, Polymarket, Limitless, Predict.fun, Rain, Opinion, Overtime V2, DFlow) unified behind MAGMA's /markets surface via a backend read-proxy and client-side order signing. Distinct from MAGMA's native binary markets.
📄️ Architecture
The aggregator's shared pattern — a backend read-proxy for markets/quotes plus client-side order signing with the user's own Privy/viem wallet. Why it is shaped this way (IP-based geoblock compliance, non-custodial keys) and the end-to-end request flow.
📄️ Platform Integrations
Per-platform reference for all eight aggregated venues — Kalshi (via DFlow), Polymarket, Limitless, Predict.fun, Rain, Opinion, Overtime V2, and DFlow. Chain, venue type, capabilities, backend service, web lib, and signing model for each.
📄️ Market Normalization
How each platform's raw upstream shape becomes a per-platform <Platform>Market interface on the backend, the common get/search/positions verbs, why there is no single unified market type, and how the /markets client composes the heterogeneous shapes.
📄️ Trading & Settlement
The aggregator's order lifecycle — build, sign, submit — across the three signing models, plus token approvals, on-chain redemption, fee and referral capture, and DFlow's sponsored/gasless execution. Per-platform specifics for all eight venues.
📄️ API Reference
The real /v1/<platform> REST endpoints exposed by magma-backend-v2 for the aggregator — DFlow/Kalshi, Polymarket, Limitless, Predict.fun, Rain, Opinion, and Overtime V2 — with method, path, and purpose. Clearly separated from /v1/markets (MAGMA's native binary markets).