Get wallet analytics by protocol

Fetch protocol-specific analytics for a wallet address

Retrieve detailed protocol-specific analytics and behavior patterns for individual wallets.

Primary Uses:

  • Individual user behavior analysis

  • Protocol-specific risk assessment

  • User segmentation and profiling

  • Competitive intelligence and benchmarking

Analytics Include:

  • Protocol Score: Wallet's reputation within specific protocol

  • Ranking: Position among all protocol users

  • Chain Usage: Multi-chain activity breakdown

  • Asset Patterns: Borrowing and collateral preferences

  • Volume Metrics: Total transaction volumes and USD values

Returns: Comprehensive wallet analytics with protocol-specific insights

Get wallet analytics by protocol

get

Retrieves detailed protocol-specific analytics for a given wallet address.

Authorizations
Path parameters
walletstringRequired

Wallet address to fetch analytics for.

Example: 0xbd723fc4f1d737dcfc48a07fe7336766d34cad5f
protocol_namestringRequired

Name of the protocol to get analytics for.

Example: aave
Query parameters
timeTravelstringOptional

Time range for analytics data in days.

Default: 90Example: 90
Header parameters
x-api-keystringRequired

API key for authentication

Default: cf1cec687fe2938f62d6b53b460b0db9998f64ef612e974980cff8423597ec93
Responses
200
Protocol-specific analytics for the wallet
application/json
get
GET /zpass/api/analytics/wallet/{wallet}/{protocol_name} HTTP/1.1
Host: api.myzscore.ai
x-api-key: cf1cec687fe2938f62d6b53b460b0db9998f64ef612e974980cff8423597ec93
Accept: */*
200

Protocol-specific analytics for the wallet

{
  "walletAddress": "0xbf0eccd64bb1b5ff949f55467e5bbe4376587c23",
  "protocol": "aave",
  "zscore": "198440136015415181312",
  "rank": 449053,
  "totalWallets": 1722669,
  "percentile": 73.93,
  "zscoreCategory": "750-850",
  "categorySummary": "Low Risk. This cluster exhibits a low-risk profile, demonstrating moderate activity levels with a balanced leverage style. Users show a strong preference for stablecoins given the extremely low volatility in their deposit mix and a moderate, though not overly aggressive, approach to borrowing. While active, their borrowing and repayment behavior suggests calculated risk management.",
  "chainUsage": [
    {
      "chainName": "arbitrum",
      "transactionCount": 12,
      "mostBorrowedAssets": [
        {
          "asset": "0x912ce59144191c1204e64559fe8253a0e49e6548",
          "volume": "9195118436820872505",
          "assetSymbol": "ARB",
          "normalizedVolume": "9.195118",
          "usdValue": "3.47",
          "tokenInfo": {
            "decimals": 18,
            "symbol": "ARB"
          }
        }
      ],
      "mostUsedCollateralAssets": [
        {
          "asset": "0x82af49447d8a07e3bd95bd0d56f35241523fbab1",
          "volume": "5381892849623950",
          "assetSymbol": "WETH",
          "normalizedVolume": "0.005382",
          "usdValue": "14.19",
          "tokenInfo": {
            "decimals": 18,
            "symbol": "WETH"
          }
        }
      ],
      "totalBorrowedVolume": "27.42",
      "totalCollateralVolume": "37.33",
      "totalVolume": "64.75"
    }
  ],
  "updatedAt": "2025-05-30T05:57:42.627Z"
}
PreviousGet Protocol Risk ClustersNextGet Global Protocol Analytics