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.

min_scorenumberOptional

Minimum score threshold for filtering wallets.

Default: 10000000000000000000

max_scorenumberOptional

Maximum score threshold for filtering wallets.

Default: 1e+41

limitnumberOptional

Maximum number of wallets to return.

Default: 100

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.testnet.myzscore.ai
x-api-key: YOUR_API_KEY
Accept: */*

200

List of wallets filtered by protocol with their scores

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