zScore Docs
  • Core
    • What is zScore
    • How It Works
    • Operational Mechanics
  • For Operators
    • Mainnet
      • Quickstart (Mainnet)
      • Registration (Mainnet)
  • For Protocols
    • Overview
    • zPass
      • Getting Started
      • API Reference
        • Get zScore by Wallet
        • Get Wallets zScore
        • Get Wallets by Protocol
        • Get Protocol Risk Clusters
        • Get wallet analytics by protocol
        • Get Global Protocol Analytics
Powered by GitBook
On this page
  1. For Protocols
  2. zPass
  3. API Reference

Get Wallets by Protocol

Get wallets filtered by protocol and score range

PreviousGet Wallets zScoreNextGet Protocol Risk Clusters

Discover wallets with protocol-specific reputation scores for targeted engagement.

Primary Uses:

  • Protocol-specific user targeting

  • Cross-protocol user acquisition

  • Competitive analysis and benchmarking

  • Protocol migration campaigns

Score Ranges:

  • 0-200: High risk wallets (new wallets, potential bots)

  • 200-400: Medium risk wallets (moderate activity)

  • 400-600: Good reputation wallets (active DeFi users)

  • 600-800: High reputation wallets (power users)

  • 800-1000: Excellent reputation wallets (whales, veterans)

Returns: Paginated list of wallets with protocol-specific zScore ratings

Get wallets by protocol

get

Retrieves wallets filtered by specific protocol and score range.

Authorizations
Query parameters
protocol_namestringRequired

Name of the protocol to filter wallets by.

Default: aave
min_scorenumberOptional

Minimum score threshold for filtering wallets.

Default: 10
max_scorenumberOptional

Maximum score threshold for filtering wallets.

Default: 1000
limitnumberOptional

Maximum number of wallets to return.

Default: 100
Header parameters
x-api-keystringRequired

API key for authentication

Default: cf1cec687fe2938f62d6b53b460b0db9998f64ef612e974980cff8423597ec93
Responses
200
List of wallets filtered by protocol with their scores
application/json
get
GET /zpass/api/zscore/wallets/protocol HTTP/1.1
Host: api.myzscore.ai
x-api-key: cf1cec687fe2938f62d6b53b460b0db9998f64ef612e974980cff8423597ec93
Accept: */*
200

List of wallets filtered by protocol with their scores

{
  "wallets": [
    {
      "walletAddress": "0xeb16ae0052ed37f479f7fe63849198df1765a733",
      "parsedScore": {
        "name": "aave",
        "zscore": "709984213858842836992"
      }
    }
  ]
}