Get Wallets by Protocol

Get wallets filtered by protocol and score range

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"
      }
    }
  ]
}