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 zScore by Wallet

Fetch zScore and Merkle proof for a specific wallet address

PreviousAPI ReferenceNextGet Wallets zScore

Retrieve individual wallet reputation scores with cryptographic proof for verification.

Primary Uses:

  • Individual wallet risk assessment

  • Onchain credit verification

  • Merkle proof validation for smart contracts

  • User onboarding and KYC scoring

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: Wallet address, numerical score, and Merkle proof array for verification

Get zScore by wallet address

get

Retrieves the zScore and Merkle proof for a specific wallet address.

Authorizations
Query parameters
addressstringRequired

Wallet address to fetch score for.

Responses
200
zScore data with Merkle proof
application/json
get
GET /zpass/api/zscore/wallet HTTP/1.1
Host: api.testnet.myzscore.ai
x-api-key: YOUR_API_KEY
Accept: */*
200

zScore data with Merkle proof

{
  "wallet_address": "0x0598df9ef51616e9c015a4f17918507259b22baf",
  "score": "50000000000000000000",
  "proof": [
    "000f9e6f9a1110dae3a4b2d9422c313b5736945902cabf1c1883492a47ab4221",
    "1d89c9f7aec54121bf9df47fc444a210aecf1fcf0eb5ed97a709f04c6310146e",
    "e9737c0e09b4ef1b631a650d403c45b36b488ebd76e4328a6e17e9f4d3d295b8",
    "cee684d3662b5728f47b8961e1abbce9372d2c8aed005f0e12bad48aeecb12d3",
    "ee192b182a345c4512998f565adab9d913f9272f06553193e1c0a9c7340a57a9",
    "c6643a0f03cecf22c22cd34706e8be6a0cb2becb3845930b69d10c2e7013b2c8",
    "f2b15b85389817e57d803417375e732961fd419dcac1ee869a62631ee34b88c8",
    "ce12867001d56613f42702e72db117578486a457b527c0cc767551d20c318ef4",
    "a20d6d17328f404b47bb4c6fdfe243a1406a87517728875332e9f17f91de9a3d",
    "0be1ca4d54e8b7bf11c89141e8ccd7884b874bd42cafb1f5cdcc0fc8ed056ff9",
    "f41d7e05d0c51bb508f0f589b22daadd1b7690cb8316f6b7f107458a1af37c20",
    "d34122603a372b5544978ec81e48f4aaded2acc7cf6b67848dbd7eede1102f77",
    "e5cef04189777ec6c4a3be9a5106f1f4b66336207dd82f192062be4cbb50150e"
  ]
}