Get zScore by Wallet

Fetch zScore and Merkle proof for a specific wallet address

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
Path parameters
addressstringRequired

Wallet address to fetch score for.

Example: 0x2E21f5d32841cf8C7da805185A041400bF15f21A
Header parameters
x-api-keystringRequired

API key for authentication

Default: cf1cec687fe2938f62d6b53b460b0db9998f64ef612e974980cff8423597ec93
Responses
200
zScore data with Merkle proof
application/json
get
GET /zpass/api/zscore/wallet/{address} HTTP/1.1
Host: api.myzscore.ai
x-api-key: cf1cec687fe2938f62d6b53b460b0db9998f64ef612e974980cff8423597ec93
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"
  ]
}
PreviousAPI ReferenceNextGet Wallets zScore