SYNDEx + Positlabs Integration

Architecture diagrams for wallet intelligence integration

6
SYNDEx Modules
CORE, TRACE, RADAR, SHIELD, STRIKE, EDGE LAB
9
API Endpoints
Wallets, Cohorts, Webhooks, Export
5
Webhook Events
rating, decay, cohort, flag, copy
6
Wallet Labels
smart, whale, sniper, mev_bot, insider, kol

System Architecture

graph TB subgraph POS[Positlabs Intelligence Layer] PARSER[Transaction Parser] RATING[Rating System] LABELS[Label Engine] WEBHOOK[Webhook Service] API[REST API] end subgraph BRIDGE[API Bridge] CLIENT[Positlabs Client] CACHE[(Redis Cache)] end subgraph SYN[SYNDEx Bot] TRACE[TRACE - Copy Trading] RADAR[RADAR - Token Discovery] SHIELD[SHIELD - Risk Check] STRIKE[STRIKE - Execution] end PARSER --> RATING PARSER --> LABELS RATING --> API LABELS --> API RATING --> WEBHOOK API --> CLIENT WEBHOOK --> CACHE CLIENT --> CACHE CACHE --> TRACE CACHE --> RADAR CACHE --> SHIELD SHIELD --> STRIKE

Key Integration Points

  • Positlabs provides wallet intelligence via REST API
  • Webhooks push real-time rating and decay updates
  • Redis cache minimizes API latency
  • TRACE uses ratings for leader selection
  • RADAR uses smart trader signals for token scoring
  • SHIELD uses labels for risk warnings

Module Dependencies

graph LR subgraph EXT[External Services] HELIUS[Helius RPC] JUPITER[Jupiter API] RUGCHECK[RugCheck API] end subgraph POS[Positlabs] RATINGS[Ratings] LABELS[Labels] DECAY[Decay States] end subgraph SYN[SYNDEx Modules] CORE[CORE] TRACE[TRACE] RADAR[RADAR] SHIELD[SHIELD] STRIKE[STRIKE] EDGE[EDGE LAB] end HELIUS --> RATINGS RATINGS --> LABELS LABELS --> DECAY RATINGS --> TRACE LABELS --> TRACE DECAY --> TRACE LABELS --> RADAR LABELS --> SHIELD RUGCHECK --> SHIELD JUPITER --> STRIKE CORE --> TRACE CORE --> RADAR CORE --> SHIELD TRACE --> EDGE RADAR --> EDGE

TRACE Copy Trading Flow

graph TB DETECT[Whale Transaction Detected] --> FETCH[Fetch Rating from Positlabs] FETCH --> API[GET /wallets/address/rating] API --> RATE[Hit Rate Score] API --> DECAY[Decay State] API --> LABEL[Labels] LABEL --> BOT{MEV Bot?} BOT -->|Yes| REJECT[Reject - Never Copy] BOT -->|No| CHECK{Hit Rate >= 60?} CHECK -->|No| REJECT CHECK -->|Yes| DSTATE{Decay State?} DSTATE -->|Sharp| FULL[Add Leader - 100% Copy] DSTATE -->|Fading| HALF[Add Leader - 50% Copy] DSTATE -->|Dead| REJECT FULL --> MONITOR[Monitor Trades] HALF --> MONITOR MONITOR --> COPY[Copy Trades to Subscribers]

TRACE Integration Points

  • Wallet ratings validate leader quality before adding to pool
  • Decay state determines copy confidence multiplier
  • MEV bot label excludes wallet from copy candidates
  • Webhooks trigger real-time leader demotion
  • Relationship graph deduplicates same-entity wallets
  • Forward performance logged to EDGE LAB

Leader Lifecycle

graph LR DISC[Discovered] --> VAL[Validating] VAL -->|High Score + Sharp| ACTIVE[Active Leader] VAL -->|High Score + Fading| REDUCED[Reduced Confidence] VAL -->|Low Score or MEV| REJ[Rejected] ACTIVE -->|decay webhook| FADING[Fading State] FADING -->|decay webhook| DEAD[Dead - Disabled] REDUCED -->|decay webhook| DEAD DEAD --> NOTIFY[Notify All Subscribers]

RADAR Token Discovery with Smart Signals

graph TB SOURCE[Token Source - Lifecycle/PumpPortal] --> CANDIDATE[RADAR Candidate] CANDIDATE --> LIQ[Liquidity Score] CANDIDATE --> TRUST[Trust Score - RugCheck] CANDIDATE --> FLOW[Flow State - Volume] CANDIDATE --> SMART[Smart Trader Check] LIQ --> BASE[Base Score 0-85] TRUST --> BASE FLOW --> BASE SMART --> COUNT{Smart Trader Count} COUNT -->|0| B0[No Boost] COUNT -->|1-2| B5[+5 Points] COUNT -->|3-5| B10[+10 Points] COUNT -->|6+| B15[+15 Points] BASE --> FINAL[Final Score] B0 --> FINAL B5 --> FINAL B10 --> FINAL B15 --> FINAL FINAL --> LANE{Lane Assignment} LANE -->|40-59| DEGEN[DEGEN Lane] LANE -->|60-79| SAFE[SAFE Lane] LANE -->|80+| PLUS[SAFE PLUS Lane]

Smart Trader Signal Logic

  • 0 smart traders = no boost (+0 points)
  • 1-2 smart traders = low signal (+5 points)
  • 3-5 smart traders = medium signal (+10 points)
  • 6+ smart traders = high signal (+15 points)
  • MEV bots excluded from smart trader count
  • Alert card shows smart trader activity

SHIELD Risk Gating with Positlabs Signals

graph TB BUY[User Buy Request] --> TOKEN[Token Mint] TOKEN --> STD[Standard Checks] STD --> RUG[RugCheck Score] STD --> LIQ[Liquidity Check] STD --> SELL[Sellability Test] TOKEN --> POS[Positlabs Checks] POS --> MEV{MEV Ratio > 30%?} POS --> INSIDER{Insiders Selling?} POS --> COORD{Coordinated Dump?} MEV -->|Yes| W1[MEV Warning] INSIDER -->|Yes| W2[Insider Warning] COORD -->|Yes| W3[Critical Warning] RUG --> RISK[Calculate Risk Score] LIQ --> RISK W1 --> RISK W2 --> RISK W3 --> RISK RISK --> MODE{User Risk Mode} MODE -->|SAFE + High Risk| BLOCK[BLOCK Trade] MODE -->|Medium Risk| WARN[WARN then Proceed] MODE -->|Low Risk| PASS[PASS - Approved] MODE -->|DEGEN Mode| WARN

Positlabs Risk Signals

  • MEV bot ratio > 30% = Medium severity warning
  • Insider wallets net selling = High severity warning
  • Coordinated selling detected = Critical severity
  • SAFE mode blocks on high risk, DEGEN warns only
  • All warnings logged for EDGE LAB analysis

Webhook Event Flow

graph TB POS[Positlabs] -->|rating.updated| WH[Webhook Endpoint] POS -->|rating.decay| WH POS -->|flag.created| WH POS -->|label.assigned| WH WH --> HMAC[Verify HMAC Signature] HMAC --> CACHE[Update Redis Cache] CACHE --> TRACE[Check TRACE Leaders] CACHE --> RADAR[Update RADAR Signals] TRACE -->|Leader Affected| ACTION{Action Required?} ACTION -->|Rating Changed| UPDATE[Update Leader Score] ACTION -->|Decay to Fading| DEMOTE[Demote - 50% Copy] ACTION -->|Decay to Dead| DISABLE[Disable Leader] DEMOTE --> NOTIFY[Notify Subscribers] DISABLE --> NOTIFY

Webhook Event Types

graph LR subgraph EVENTS[Positlabs Events] E1[rating.updated] E2[rating.decay] E3[flag.created] E4[label.assigned] end subgraph ACTIONS[SYNDEx Actions] A1[Update Cache] A2[Recalc Leader Score] A3[Demote/Disable Leader] A4[Notify Subscribers] A5[Add Discovery Candidate] A6[Update Classification] end E1 --> A1 E1 --> A2 E2 --> A1 E2 --> A3 E2 --> A4 E3 --> A1 E3 --> A5 E4 --> A1 E4 --> A6

Data Flow Between Systems

graph TB subgraph PDATA[Positlabs PostgreSQL] PW[(walletRatings)] PL[(walletLabels)] PF[(forwardSnapshots)] end subgraph RCACHE[Redis Cache Layer] C1[wallet:rating:ADDR - TTL 5min] C2[wallet:labels:ADDR - TTL 5min] C3[wallet:decay:ADDR - TTL 1hr] C4[traders:smart - TTL 10min] end subgraph SDATA[SYNDEx Supabase] TW[(trace_wallets)] RT[(radar_tokens)] TR[(trades)] end PW -->|API| C1 PL -->|API| C2 PW -->|Webhook| C3 PL -->|API| C4 C1 --> TW C2 --> TW C3 --> TW C4 --> RT C1 --> TR

Label to Action Mapping

graph LR subgraph LABELS[Positlabs Labels] L1[smart] L2[whale] L3[sniper] L4[mev_bot] L5[insider] L6[kol] end subgraph TRACE_ACT[TRACE Actions] T1[Leader Candidate] T2[Track Closely] T3[Monitor Entries] T4[Never Copy] T5[Monitor Only] T6[Track Sentiment] end subgraph RADAR_ACT[RADAR Impact] R1[+10 Score Boost] R2[+5 Score Boost] R3[+5 Score Boost] R4[Exclude from Count] R5[No Impact] R6[Note in Alert] end L1 --> T1 L1 --> R1 L2 --> T2 L2 --> R2 L3 --> T3 L3 --> R3 L4 --> T4 L4 --> R4 L5 --> T5 L5 --> R5 L6 --> T6 L6 --> R6