{"uid":"cap_c9-hITGJYpHQuFIakWfo8","slug":"kyc-madhousewallet-com-86839053","name":"Madhouse Wallet KYC Status Lookup","description":"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.","url":"https://kyc.madhousewallet.com/api/public/kyc/status","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"wallet":"0x742d35Cc6634C0532925a3b844Bc9e7595f42bE2"}}},"response":{"chain":null,"easUID":null,"txHash":null,"verified":false,"riskScore":null,"verifiedAt":null,"walletAddress":"0x742d35cc6634c0532925a3b844bc9e7595f42be2","attestationHash":null,"verificationMethods":null,"sasAttestationAddress":null}},"exampleRequest":{"wallet":"0x742d35Cc6634C0532925a3b844Bc9e7595f42bE2"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gQzEhcGS-B-wVlXPDv4ti","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a given EVM or Solana wallet address has a verified on-chain KYC attestation, returning verification status, risk score, and attestation details.","exampleAgentPrompt":"Can you check whether wallet 0x4A9f2c1B3e8D7a0F5c6E is KYC-verified and what its risk score is?","exampleUseCases":[{"title":"Gating DeFi access for verified users","prompt":"Before we let someone stake in our protocol, can you check if their wallet address has passed KYC verification and tell me their risk score?"},{"title":"Compliance screening for large transfers","prompt":"A user wants to withdraw 50 ETH from our platform. Can you verify whether their wallet has a valid on-chain KYC attestation and let me know if it's flagged as high risk?"},{"title":"Building a trusted peer-to-peer marketplace","prompt":"We're launching a P2P trading feature and want to prioritize verified users. Can you check a wallet address to see if they have KYC verification on-chain and what verification methods they used?"}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:26:18.816Z","isFirstParty":false}