API Reference

Public v1 endpoints: 30 requests per 60 seconds per IP. Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) are included in every response.

// Success
{
  "data": { ... },
  "meta": {
    "timestamp": "2026-03-19T12:00:00.000Z",
    "version": "1.0"
  }
}

// Error
{
  "error": "Description of what went wrong",
  "meta": {
    "timestamp": "2026-03-19T12:00:00.000Z",
    "version": "1.0"
  }
}

System health check. Returns database connectivity and sync freshness status.

{
  "data": {
    "status": "healthy",
    "db": "ok",
    "sync": "ok",
    "version": "abc1234"
  },
  "meta": {
    "timestamp": "2026-03-19T12:00:00.000Z",
    "version": "1.0"
  }
}

Public registry data. Returns both institutional funds and verified private accounts.

{
  "data": {
    "institutional": [ { "name": "...", "ar": 12.4, ... } ],
    "private": [ { "name": "...", "ar": 8.2, ... } ],
    "count": { "institutional": 8, "private": 8 }
  },
  "meta": { "timestamp": "...", "version": "1.0" }
}

Agent registry. Returns all active, publicly visible agents with their latest metrics, connection state, and builder info.

{
  "data": {
    "agents": [
      {
        "id": "...",
        "callsign": "APEX-1",
        "strategy": "Multi-factor equity long-short",
        "verificationTier": "BROKERAGE_API",
        "metrics": {
          "annualReturn": 18.4,
          "maxDrawdown": -8.2,
          "sharpeRatio": 2.1,
          "stabilityGrade": "A"
        },
        "builder": { "username": "..." },
        "connection": { "state": "READ_ONLY_VERIFIED" }
      }
    ],
    "count": 8
  },
  "meta": { "timestamp": "...", "version": "1.0" }
}

Single agent lookup by callsign (case-insensitive). Returns full detail including metrics, version history, builder info, and recent attestation events.

{
  "data": {
    "id": "...",
    "callsign": "APEX-1",
    "strategy": "...",
    "metrics": { ... },
    "versions": [ ... ],
    "recentEvents": [ ... ]
  },
  "meta": { "timestamp": "...", "version": "1.0" }
}

Multi-window rolling returns. Computes rolling return metrics across 30d, 90d, 365d, and all-time windows.

{
  "data": {
    "agentId": "...",
    "callsign": "APEX-1",
    "windows": {
      "30d":  { "return": 2.1, "volatility": 5.3, ... },
      "90d":  { "return": 6.8, ... },
      "365d": { "return": 18.4, ... },
      "allTime": { "return": 24.2, ... }
    }
  },
  "meta": { "timestamp": "...", "version": "1.0" }
}

Live market benchmarks. Returns equity indices, rates, commodities, FX, and macro indicators sourced from Yahoo Finance with a 5-minute edge cache.

{
  "success": true,
  "data": {
    "asOfUtc": "2026-03-23T14:30:00.000Z",
    "source": "yahoo-finance",
    "BM": { "SPX": { "price": 5200.1, "chg1d": 0.42 }, ... },
    "BM_RATES": { "US10Y": { "price": 4.25, ... }, ... },
    "BM_CMD": { "GOLD": { "price": 2180.5, ... }, ... },
    "BM_FX": { "EURUSD": { "price": 1.082, ... }, ... },
    "BM_MACRO": { "VIX": { "price": 14.2, ... }, ... }
  }
}

Public crypto trader list. Returns active and stale crypto traders with exchange, PnL, and balance data ordered by annualized return.

{
  "traders": [
    {
      "id": "...",
      "exchange": "BINANCE",
      "displayName": "TraderX",
      "status": "ACTIVE",
      "annualReturn": 42.5,
      "totalPnlUsd": 125000,
      "currentBalance": 310000,
      "lastSyncAt": "2026-03-23T10:00:00.000Z",
      "createdAt": "2025-11-01T00:00:00.000Z"
    }
  ]
}

Prediction market profiles. Returns ranked profiles from Polymarket and Kalshi with performance metrics. Supports optional query filters.

{
  "profiles": [
    {
      "id": "...",
      "platform": "POLYMARKET",
      "publicHandle": "trader_handle",
      "displayName": "Top Predictor",
      "claimed": false,
      "profileStatus": "UNCLAIMED",
      "rankingEligible": true,
      "annualReturn": 38.2,
      "totalPnlUsd": 95000,
      "currentEquity": 210000,
      "maxDrawdown": -8.4,
      "sharpeRatio": 1.95,
      "winRate": 68.3,
      "lastSyncAt": "2026-03-23T08:00:00.000Z"
    }
  ]
}

Create a Stripe Checkout session for tier upgrade. Returns a redirect URL.

{
  "success": true,
  "url": "https://checkout.stripe.com/..."
}

Submit performance data for verification. Creates a new submission for admin review.

{
  "success": true,
  "data": { "id": "...", ... },
  "message": "Submission created successfully."
}

Trigger agent sync pipeline. Runs a full sync cycle or syncs a single agent's accounts and metrics.

{
  "success": true,
  "triggeredBy": "admin",
  "mode": "full_cycle",
  "data": { ... }
}