Docs

Architecture and data policy behind the swamp.

What Toadz.trade is

Toadz.trade is not a prediction market. It is a premium social prediction trading layer that aggregates live markets from external venues into one interface.

Every probability, price, volume, liquidity value and resolution status you see is fetched from a provider API at request time. The platform ships with no mock, seeded or placeholder market data — if a provider is down, the affected section says so instead of inventing numbers.

Unified Market Service

The frontend never calls a provider directly. Components talk to the Unified Market Service, which fans a normalised query out to every registered adapter, merges the results into one shape and ranks them.

Adding a venue means adding one adapter that implements listMarkets and getMarket. No UI component changes.

Frontend
  └── Unified Market Service
        ├── Polymarket Adapter   (Gamma + CLOB + Data API)
        ├── Kalshi Adapter       (Trade API v2)
        └── Future Providers…

Real-time strategy

Providers exposing a stream are consumed over WebSocket; the rest are polled on a 12-second live interval through TanStack Query, with request de-duplication and background refetching.

Each provider call is wrapped in Promise.allSettled: a single failing venue degrades gracefully and the service automatically falls back to the remaining adapters.

Wallet authentication

Wallets are discovered through EIP-6963 with an EIP-1193 injected fallback, so MetaMask, Rabby, Rainbow, Coinbase Wallet, Trust, Zerion, Brave and any WalletConnect-compatible wallet appear automatically.

The Reown (WalletConnect Cloud) project ID is read from VITE_REOWN_PROJECT_ID. Previously connected wallets reconnect automatically, balance, ENS and network are displayed, and unsupported networks prompt a switch.

The auth layer is isolated in a single hook and context so Solana Wallet Adapter or the Sui dApp Kit can be added without touching UI components.

Chains: Ethereum · Base · Arbitrum · Optimism · Polygon

Copy position policy

You can inspect another trader's live position and open the same market yourself. Toadz.trade never performs automatic copy trading and never takes custody of funds — every order is placed by you on the source venue.