# Madhouse Wallet KYC Status Lookup

> Madhouse Wallet KYC Status Lookup is a paid API for AI agents from kyc.madhousewallet.com, paid per call via x402, $0.01/call, status down (last checked 2026-09-16).

Checks whether a given EVM or Solana wallet address has a verified on-chain KYC attestation, returning verification status, risk score, and attestation details.

## Facts

- Endpoint: GET https://kyc.madhousewallet.com/api/public/kyc/status
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kyc-madhousewallet-com-86839053
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c9-hITGJYpHQuFIakWfo8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kyc-madhousewallet-com-86839053
```

Example prompt: Can you check whether wallet 0x4A9f2c1B3e8D7a0F5c6E is KYC-verified and what its risk score is?

## When to prefer this

Use this endpoint when you need to programmatically verify whether a specific wallet address holds a valid, on-chain EAS-backed KYC attestation — especially in compliance, DeFi gating, or identity-sensitive workflows. Prefer this over off-chain identity checks when you need tamper-resistant proof anchored to the Base blockchain. It's also useful for assessing wallet risk score before allowing access to a service.

## Known failure modes

- Wallet address not found or never submitted for KYC — verified returns false with null attestation fields
- Invalid wallet address format — likely returns an error or empty result
- Payment failure (insufficient USDC balance) — request blocked before processing
- Revoked attestation — verified returns false even if previously verified
- Network or upstream attestation service unavailable — may return error or timeout

## How this service works

Look up KYC status for any wallet. Costs $0.01 USDC. Pass ?wallet=0x... to check any address, or omit to check the paying wallet itself. Returns verified (bool), chain, attestation details, verificationMethods, and risk score.

## Output

Returns a JSON object containing: verified (bool indicating an active, non-revoked EAS on-chain attestation), walletAddress (the queried address), riskScore (low or high), verifiedAt (Unix timestamp), easUID (EAS attestation UID), txHash (Base chain transaction hash), attestationHash (keccak256 of attestation payload), and verificationMethods including selfieCheck status and documentType (passport, driving_license, or id_card).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "wallet": "0x742d35Cc6634C0532925a3b844Bc9e7595f42bE2"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "wallet": {
       "type": "string",
       "description": "Wallet address to look up (0x EVM or base58 Solana). If omitted, the paying wallet is used."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "easUID": {
       "type": "string",
       "description": "EAS attestation UID, or null"
      },
      "txHash": {
       "type": "string",
       "description": "EAS tx hash on Base, or null"
      },
      "verified": {
       "type": "boolean",
       "description": "True only if on-chain EAS attestation exists and is not revoked"
      },
      "riskScore": {
       "type": "string",
       "description": "Identity risk assessment: low | high, or null"
      },
      "verifiedAt": {
       "type": "number",
       "description": "Unix seconds when identity was verified, or null"
      },
      "walletAddress": {
       "type": "string",
       "description": "The queried wallet address"
      },
      "attestationHash": {
       "type": "string",
       "description": "keccak256 of attestation payload, or null"
      },
      "verificationMethods": {
       "type": "object",
       "properties": {
        "selfieCheck": {
         "type": "string",
         "description": "verified | unverified | failed, or null"
        },
        "documentType": {
         "type": "string",
         "description": "passport | driving_license | id_card, or null"
        }
       },
       "description": "How identity was verified"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kyc-madhousewallet-com-86839053/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kyc.madhousewallet.com](https://www.zero.xyz/host/kyc.madhousewallet.com/llms.txt)