zScore Docs
  • Core
    • What is zScore
    • How It Works
    • Operational Mechanics
  • For Operators
    • Mainnet
      • Quickstart (Mainnet)
      • Registration (Mainnet)
  • For Protocols
    • Overview
    • zPass
      • Getting Started
      • Use Cases
        • Risk Assessment
        • User Segmentation
        • Sybil Detection
        • Reputation Scoring
      • API Reference
        • Get zScore by Wallet
        • Get Wallets zScore
        • Get Wallets by Protocol
        • Get All Categories
        • Get Protocol Analytics by Wallet
        • Get Global Protocol Analytics
Powered by GitBook
On this page
  1. For Protocols
  2. zPass
  3. API Reference

Get Protocol Analytics by Wallet

Fetch protocol-specific analytics for a wallet address

PreviousGet All CategoriesNextGet Global Protocol Analytics

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 protocol analytics by wallet

get

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

Authorizations
Query parameters
walletstringRequired

Wallet address to fetch analytics for.

protocol_namestringRequired

Name of the protocol to get analytics for.

Responses
200
Protocol-specific analytics for the wallet
application/json
get
GET /zpass/api/analytics/wallet HTTP/1.1
Host: api.testnet.myzscore.ai
x-api-key: YOUR_API_KEY
Accept: */*
200

Protocol-specific analytics for the wallet

{
  "walletAddress": "0xbf0eccd64bb1b5ff949f55467e5bbe4376587c23",
  "protocol": "aave",
  "zscore": "198440136015415181312",
  "rank": 449053,
  "totalWallets": 1722669,
  "percentile": 73.93,
  "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"
}