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?

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