WalletClassifyData Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "WalletClassifyData",
  "description": "Bulk wallet classification response body.",
  "type": "object",
  "required": [
    "date",
    "total",
    "wallets"
  ],
  "properties": {
    "date": {
      "description": "Daily snapshot date.",
      "type": "string",
      "example": "2026-06-16"
    },
    "total": {
      "description": "Total wallets matching the filters.",
      "type": "integer",
      "format": "int64",
      "example": 4444
    },
    "wallets": {
      "type": "array",
      "items": {
        "description": "Wallet plus its precomputed behavior metrics.",
        "type": "object",
        "required": [
          "address",
          "metrics",
          "period"
        ],
        "properties": {
          "address": {
            "description": "Wallet address.",
            "type": "string",
            "example": "0x010461c14e146ac35fe42271bdc1134ee31c703a"
          },
          "metrics": {
            "description": "Precomputed wallet behavior metrics.",
            "type": "object",
            "properties": {
              "active_hours": {
                "type": "integer",
                "format": "int64"
              },
              "avg_order_size_usd": {
                "type": "number"
              },
              "buy_volume_usd": {
                "type": "number"
              },
              "cancel_rate": {
                "type": "number"
              },
              "cloid_ratio": {
                "type": "number"
              },
              "fill_rate": {
                "type": "number"
              },
              "ioc_ratio": {
                "type": "number"
              },
              "liquidation_count": {
                "type": "integer",
                "format": "int64"
              },
              "long_short_ratio": {
                "type": "number"
              },
              "maker_ratio": {
                "type": "number"
              },
              "max_order_size_usd": {
                "type": "number"
              },
              "max_single_fill_usd": {
                "type": "number"
              },
              "median_cancel_speed_ms": {
                "type": "number"
              },
              "order_to_trade_ratio": {
                "type": "number"
              },
              "post_only_ratio": {
                "type": "number"
              },
              "realized_pnl_usd": {
                "type": "number"
              },
              "sell_volume_usd": {
                "type": "number"
              },
              "top_builder": {
                "type": "string",
                "nullable": true
              },
              "total_builder_fees_paid": {
                "type": "number"
              },
              "total_fees_usd": {
                "type": "number"
              },
              "total_fills": {
                "type": "integer",
                "format": "int64"
              },
              "total_orders": {
                "type": "integer",
                "format": "int64"
              },
              "total_priority_gas_paid": {
                "type": "number"
              },
              "total_volume_usd": {
                "type": "number"
              },
              "tpsl_ratio": {
                "type": "number"
              },
              "trigger_order_ratio": {
                "type": "number"
              },
              "twap_fill_ratio": {
                "type": "number"
              },
              "unique_coins_traded": {
                "type": "integer",
                "format": "int64"
              },
              "unique_fill_coins": {
                "type": "integer",
                "format": "int64"
              },
              "uses_builder": {
                "type": "boolean"
              },
              "uses_cloid": {
                "type": "boolean"
              },
              "uses_priority_gas": {
                "type": "boolean"
              },
              "uses_tpsl": {
                "type": "boolean"
              },
              "uses_twap": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "period": {
            "description": "Metric lookback period.",
            "type": "string",
            "example": "24h"
          }
        }
      }
    }
  }
}