Notifications

The Notification Builder lets you create real-time alert streams powered by smart money intelligence. Get notified when top-ranked wallets converge on a token, make whale trades, or trigger sell signals.

What You Can Build

Use Case	Signal Type	Example
Smart money convergence alerts	`convergence_p0`, `convergence_p1`	"5 top traders bought $TOSHI in 6 hours"
Whale trade notifications	`whale_move`	"Top-50 wallet made a $85K trade"
Sell signal warnings	`sell_signal`	"3 top wallets sold $TOKEN"
Trader leaderboards	Leaderboard API	Ranked wallets by PnL, win rate, score

How It Works

Smart Money Engine
        │
   Monitors top wallets across Base, Ethereum, Solana
        │
   Detects patterns (convergence, whale moves, sells)
        │
   Generates signals matching your config
        │
   ┌────┴────┐
   │         │
  Poll    Webhook
  GET /notifications    POST to your URL

Configure — set which signal types, chains, quality gates, and delivery preferences you want
Receive — poll GET /notifications every 10-30s, or set up a webhook for push delivery
Act — each signal includes a cta (call-to-action) with token address and chain for deep-linking to swap UIs

Console Notification Builder

The Console Notification Builder lets you:

Select signal types — convergence (P0/P1), whale moves, sell signals
Choose chains — Base, Ethereum, Solana
Set quality gates — minimum trader score, win rate, token liquidity
Configure delivery — daily budget, per-type limits, cooldown between duplicates
Set webhook — receive signals via POST to your endpoint

Key Concepts

Trader Score

Wallets are ranked by a composite metric:

Component	Weight	What it measures
PnL efficiency	40%	Net PnL / buy volume
Win rate	30%	Bayesian-smoothed from closed positions
Consistency	20%	Number of closed positions
Activity	10%	Log-normalized trade count

Signal Priority

Priority	Type	Trigger
P0 (highest)	`convergence_p0`	5+ top wallets bought the same token
P1	`convergence_p1`	3-4 top wallets bought the same token
P1	`whale_move`	Top-50 wallet trade exceeding threshold
P2	`sell_signal`	Multiple top wallets selling the same token

Budget & Cooldown

Daily budget — max notifications per day (default: 15-30)
Per-type limits — caps per signal type
Cooldown — minimum hours between duplicate signals for the same token (default: 2h)

Quick Start

1. Check your config

curl https://api.mbd.xyz/v3/alpha/config \
  -H "Authorization: Bearer mbd-YOUR_KEY"

2. Poll for signals

curl "https://api.mbd.xyz/v3/alpha/notifications?since=2026-03-24T00:00:00Z&limit=10" \
  -H "Authorization: Bearer mbd-YOUR_KEY"

3. View the leaderboard

curl "https://api.mbd.xyz/v3/alpha/leaderboard?chain=base&limit=10" \
  -H "Authorization: Bearer mbd-YOUR_KEY"

What's Next

Building Notification Streams → Step-by-step configuration guide
Smart Money Signals → Complete API reference with polling patterns and webhook setup
API Reference: Leaderboard — endpoint specification