{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/alphayou-net/json-schema/alphayou-net-trader-feed-schema.json",
  "title": "TraderFeed",
  "x-generated": "2026-11-06",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/alphayou-net-app-openapi.json#/components/schemas/TraderFeed",
  "type": "object",
  "required": [
    "items",
    "total",
    "limit",
    "offset"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/TraderFeedItem"
      }
    },
    "total": {
      "type": "integer",
      "description": "Traders matching the filter, not just this page."
    },
    "limit": {
      "type": "integer"
    },
    "offset": {
      "type": "integer"
    }
  },
  "additionalProperties": true,
  "$defs": {
    "TraderFeedItem": {
      "type": "object",
      "description": "One row of the feed. A null field means 'not observed', not zero.",
      "required": [
        "address"
      ],
      "properties": {
        "address": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$"
        },
        "display_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "trader_score": {
          "type": [
            "number",
            "null"
          ],
          "description": "Mirror Score, 0-10. Nine signals; maximum observed drawdown carries the largest weight."
        },
        "breakdown": {
          "type": "object",
          "description": "Per-signal sub-scores behind trader_score.",
          "additionalProperties": {
            "type": "number"
          }
        },
        "total_pnl": {
          "type": [
            "number",
            "null"
          ],
          "description": "Perpetuals all-time PnL, USD."
        },
        "combined_total_pnl": {
          "type": [
            "number",
            "null"
          ],
          "description": "Perps plus spot plus staking, USD."
        },
        "pnl_30d": {
          "type": [
            "number",
            "null"
          ]
        },
        "annualised_roi_pct": {
          "type": [
            "number",
            "null"
          ],
          "description": "Cash-flow-adjusted annualised return, percent."
        },
        "max_drawdown_pct": {
          "type": [
            "number",
            "null"
          ],
          "description": "Deepest observed drawdown, percent. 60 or more disqualifies a wallet."
        },
        "sharpe": {
          "type": [
            "number",
            "null"
          ]
        },
        "sortino": {
          "type": [
            "number",
            "null"
          ]
        },
        "efficiency_pct": {
          "type": [
            "number",
            "null"
          ],
          "description": "PnL as a percentage of lifetime volume."
        },
        "account_value": {
          "type": [
            "number",
            "null"
          ],
          "description": "Perpetuals account value, USD."
        },
        "open_positions": {
          "type": [
            "integer",
            "null"
          ]
        },
        "open_notional_usd": {
          "type": [
            "number",
            "null"
          ]
        },
        "history_days": {
          "type": [
            "integer",
            "null"
          ]
        },
        "up_weeks": {
          "type": [
            "integer",
            "null"
          ]
        },
        "down_weeks": {
          "type": [
            "integer",
            "null"
          ]
        },
        "trading_since": {
          "type": [
            "string",
            "null"
          ],
          "format": "date"
        },
        "analyzed_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "Last successful rescore."
        },
        "staleness_hours": {
          "type": [
            "number",
            "null"
          ]
        },
        "current_assets": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "current_asset_tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "copier_count": {
          "type": "integer",
          "description": "Active copy strategies pointed at this trader."
        }
      },
      "additionalProperties": true
    }
  }
}