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

Solana wallets are discovered through Wallet Standard and WalletConnect v2, including Phantom, Solflare and compatible mobile wallets.

The Reown project ID is read from VITE_REOWN_PROJECT_ID. Previously connected wallets reconnect automatically, while SOL balances and Solana Mainnet status stay current.

A signed Solana message is verified with Ed25519 before a persistent account session is issued; signing never costs gas.

Chain: Solana Mainnet

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.