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

HTTPcURLJavaScriptPython

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