SYNDEx Integration

Executive Summary

POSITx (Books + Scorecard) provides post-trade analytics capabilities that complement SYNDEx's execution engine. This integration enables real-time PnL attribution, copy detection, wallet intelligence, and tax reporting for SYNDEx users.

Key Points

• Parser is LIVE against Helius (Solana mainnet) - not mocked
• 96.3% venue identification accuracy across 4,468 real transactions
• FIFO/HIFO cost basis engine - tested with 28 tests, 5,361 assertions
• Full OpenAPI spec available at /api/v1/openapi.json
• Webhook infrastructure ready for bi-directional events

What is LIVE vs MOCKED?

Integration Architecture

┌─────────────────────────────────────────────────────────────┐
│                     SYNDEx                                  │
│  (Execution Engine - Independent)                           │
│                                                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │ Order Entry │  │  Execution  │  │  Receipts   │         │
│  └─────────────┘  └─────────────┘  └──────┬──────┘         │
└────────────────────────────────────────────┼────────────────┘
                                             │
                                             ▼
                          ┌──────────────────────────────┐
                          │     Trade Receipt Webhook    │
                          │  POST /api/syndex/receipt    │
                          │  {                           │
                          │    signature: "...",         │
                          │    wallet: "...",            │
                          │    chain: "solana",          │
                          │    timestamp: "..."          │
                          │  }                           │
                          └──────────────────────────────┘
                                             │
                                             ▼
┌─────────────────────────────────────────────────────────────┐
│                     POSITx                                  │
│  (Post-Trade Analytics Layer)                               │
│                                                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │   Parser    │→→│ Cost Basis  │→→│    PnL      │         │
│  │ (real-time) │  │   Engine    │  │ Attribution │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
│                                                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │  Scorecard  │  │ Tax Reports │  │   Webhooks  │         │
│  │  Ratings    │  │  Form 8949  │  │   (events)  │         │
│  └─────────────┘  └─────────────┘  └──────┬──────┘         │
└────────────────────────────────────────────┼────────────────┘
                                             │
                                             ▼
                          ┌──────────────────────────────┐
                          │    Webhook to SYNDEx         │
                          │  • wallet.rating.updated     │
                          │  • alert.copy_detected       │
                          │  • wallet.decay_state.changed│
                          └──────────────────────────────┘
        

What SYNDEx Gets

1. Real-time PnL attribution for executed trades
2. Copy detection alerts - is someone front-running your signals?
3. Wallet ratings for any address (smart money scoring)
4. Performance benchmarking vs tracked wallets
5. Tax-ready export for end users

What POSITx Needs from SYNDEx

1. Trade receipts (signature + wallet + timestamp) - read-only
2. Webhook notifications when trades execute
3. Historical trade data for backfill (optional)

Implementation Timeline

Checklist for Alex

Immediate Actions (This Week)

• Sign NDA

  Justin will send today
• Provide GitHub username

  For POSITx repo access (read-only)
• Grant Justin SYNDEx read-only access

  To understand your data model
• Review integration brief

  This document
• Test the parser

  HELIUS_API_KEY="key" pnpm --filter cli test-wallet <your_wallet>

Information Needed from Alex

Trade Receipt Questions

What fields does SYNDEx have per trade?

• Transaction signature?
• Wallet address?
• Token in/out amounts?
• Execution price?
• Timestamp?
• Venue/DEX used?

Alex's Pre-Integration Questions (Answered)

Before writing integration code, Alex asked for confirmation on these items:

Sample Webhook Payloads

rating.updated

{
  "event": "wallet.rating.updated",
  "timestamp": "2026-06-09T10:30:00Z",
  "data": {
    "wallet": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
    "rating": {
      "score": 847,
      "percentile": 94.2,
      "tier": "elite",
      "previousScore": 823,
      "delta": 24
    },
    "labels": ["smart_money", "whale", "early_adopter"],
    "decayState": "sharp"
  }
}

decay_state.changed

{
  "event": "wallet.decay_state.changed",
  "timestamp": "2026-06-09T10:30:00Z",
  "data": {
    "wallet": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
    "previousState": "sharp",
    "newState": "fading",
    "daysSinceLastTrade": 14,
    "rating": {
      "score": 720,
      "percentile": 82.1
    }
  }
}

flag.created

{
  "event": "alert.wallet.flagged",
  "timestamp": "2026-06-09T10:30:00Z",
  "data": {
    "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "flag": "smart_money",
    "confidence": 0.94,
    "reason": "Consistent 70%+ win rate over 200+ trades",
    "metrics": {
      "winRate": 0.73,
      "avgReturn": 2.4,
      "tradeCount": 234
    }
  }
}

label.assigned

{
  "event": "wallet.label.assigned",
  "timestamp": "2026-06-09T10:30:00Z",
  "data": {
    "wallet": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "label": "sniper_bot",
    "confidence": 0.89,
    "evidence": {
      "avgBlockDelay": 1.2,
      "consistentSlippage": true,
      "automatedPatterns": true
    },
    "relatedWallets": [
      "3xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgHHH"
    ]
  }
}

Integration Model Options

Option A: Push Model

• SYNDEx sends trade receipts to POSITx via webhook
• POSITx processes and sends back analytics via webhook

Option B: Pull Model

• POSITx polls SYNDEx API for new trades
• SYNDEx calls POSITx API for ratings/analytics

Option C: Hybrid (Recommended)

• Webhooks for real-time events
• API calls for on-demand data

API Endpoints Available

GET  /api/v1/wallets/{address}/rating    - Wallet score, decay state, labels
GET  /api/v1/wallets/leaderboard         - Top wallets by score
GET  /api/v1/wallets/search              - Search by address prefix
GET  /api/v1/cohorts                     - Cohort retention metrics
GET  /api/v1/cohorts/{month}             - Cohort detail + decay curve
POST /api/v1/webhooks                    - Subscribe to events
GET  /api/v1/webhooks                    - List subscriptions
DEL  /api/v1/webhooks/{id}               - Unsubscribe
POST /api/v1/export/url                  - Generate signed export URLs

Webhook Events

Next Steps

Once Alex provides the checklist items:

1. Justin sets up POSITx repo access
2. Schedule 30-min call to align on spec
3. Start AWS deployment in parallel
4. Working integration in 6-8 weeks