Skip to main content
TL;DR: Predicade is non-custodial. We never have access to your funds.

System Architecture

Here’s how Predicade works under the hood:
Predicade Architecture Diagram

Predicade Core

Predicade Core listens directly to the Polygon blockchain. Every transaction that happens on Polymarket’s contracts is captured in real-time - no intermediaries, no delays.

Predicade Engine

Once Core receives a transaction, it uses the Engine to enrich and analyze it:
ComponentWhat It Provides
Data APIWho traded - track record, registration date, etc.
Gamma APIAction details - which market, how much, which outcome
Predicade DBYour history and preferences for analysis
Core combines all this data, runs it against your filter settings, and stores analysis results back to the database.

User

When a trade matches your criteria, Core forwards alerts to you through:
ChannelDescription
TelegramInstant push notifications to your phone
Predicade UIReal-time alerts in the web dashboard
OthersFuture integrations (Discord, webhooks, etc.)

Predicade Trading Interface

All user channels connect to the Trading Interface, so you can act on any alert immediately - one click from notification to trade.
Because we listen directly to the blockchain, trades appear within a second of happening on-chain. No middlemen, no manipulation.

Trading Infrastructure

Polymarket Safe

We integrate directly with Polymarket’s Safe infrastructure using the Polymarket SDK. When you enable trading:
  1. Your existing Polymarket Safe is used (or created if you never used it)
  2. Session keys are derived locally in your browser
  3. Trades execute through the same contracts as polymarket.com
This means:
  • Full mirror - trades, orders, balance changes, positions - everything you do on Predicade appears on polymarket.com and vice versa
  • Same Safe - your Predicade and Polymarket balances are identical
  • Same contracts - audited, battle-tested, handling millions daily
  • Gasless trading - no POL needed for most operations

Non-Custodial

WhatPredicade Access
Your fundsNone
Private keysNone
Session keysNone - stored in your browser only
Trade executionOnly what you sign
Clearing browser data removes your session keys. You’ll need to re-enable trading.

Data Storage

DataStored
Wallet addressYes
Polymarket proxy addressYes
Filter settingsYes
Alert historyYes
Private keysNever
Trading historyNo (on-chain)

Alert Latency

Predicade is optimized for speed. Here’s what to expect:
ScenarioTypical Latency
Standard alerts~1ms from chain settlement
With Trader Age filter (cached user)~1ms from chain settlement
With Trader Age filter (first trade from new user)Higher latency

Why Trader Age Filtering Can Add Latency

When you enable the Trader Account Age filter, Predicade needs to look up each trader’s registration date. For traders we’ve seen before, this data is cached and adds no delay. However, when a trader makes their first trade that matches your filters, we need to fetch their account age from the Data API. This lookup happens in real-time, which can add latency to that specific alert.
After the first trade, that trader’s age is cached, and subsequent alerts for them will be delivered at normal speed (~1ms).

Recommendations

  • If you prioritize lowest possible latency, consider disabling the Trader Age filter
  • If you use Trader Age filtering, expect occasional delays on first trades from new-to-you traders
  • The tradeoff is worth it if filtering by account age is important to your strategy

FAQ

No. We never have access to your private keys. Smart contracts only respond to signatures from your wallet.
No. Same Safe, same balance. Deposit on Predicade, it appears on Polymarket and vice versa.
Your funds are safe. Session keys are stored locally in your browser, not on our servers.

Next Steps