KYW response examples
Compare custodial, self-hosted, unknown, and registered-agent results.
These examples illustrate fresh-check responses. Optional entity and risk fields vary by the evidence available. Compare the response field definitions when building your parser.
Example: Custodial Wallet
{
"id": "0f59b0db-3c42-4f2f-9a1f-35c6ccbc4f46",
"address": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
"blockchain": "Ethereum",
"walletType": "CUSTODIAL",
"confidenceScore": 75,
"confidence": "HIGH",
"isVerified": true,
"attributionReason": "Blockchain analytics identified the wallet owner as Example Exchange.",
"attributionReasonCode": "DETECTED_VIA_BLOCKCHAIN_ANALYTICS",
"agenticBehaviour": {
"detected": true,
"confidenceScore": 35,
"confidence": "MEDIUM",
"isVerified": false,
"attributionReason": "Wallet shows automated behaviour including high transaction frequency.",
"attributionReasonCode": "DETECTED_VIA_BEHAVIORAL_ANALYSIS"
},
"riskScore": 18,
"auditLogId": "0f59b0db-3c42-4f2f-9a1f-35c6ccbc4f46",
"entityInfo": {
"entityId": "14f4fb9d-4c69-5843-8b18-dbb77540182b",
"name": "Example Exchange",
"legalName": "Example Exchange OÜ",
"type": "exchange",
"isVerified": true,
"inNetwork": true,
"updatedAt": "2026-06-01T10:00:00.000Z",
"isRiskAssessed": true,
"description": "Example custodial virtual asset service provider.",
"isMicaCompliant": true,
"belongsToWarningList": false,
"countries": ["Estonia"],
"url": "https://example.com",
"riskAssessment": {
"riskScore": "LOW"
}
}
}
Example: Verified Self-Hosted Wallet
{
"id": "b2ff7a37-42d8-4b2c-9a36-3caa7d8d63d0",
"address": "0x32Be343B94f860124dC4fEe278FDCBD38C102D88",
"blockchain": "Ethereum",
"walletType": "NON_CUSTODIAL",
"confidenceScore": 90,
"confidence": "HIGH",
"isVerified": true,
"attributionReason": "The wallet has a completed self-hosted wallet verification.",
"attributionReasonCode": "VERIFIED_SELF_HOSTED_WALLET",
"agenticBehaviour": {
"detected": false,
"confidenceScore": 0,
"confidence": "LOW",
"isVerified": false,
"attributionReason": null,
"attributionReasonCode": null
},
"riskScore": null,
"auditLogId": "b2ff7a37-42d8-4b2c-9a36-3caa7d8d63d0",
"entityInfo": null
}
Example: Unknown Wallet
{
"id": "7b181f74-6c8f-4c62-8e87-67a8d0797dd3",
"address": "bc1qexampleaddress000000000000000000000000",
"blockchain": "Bitcoin",
"walletType": "UNKNOWN",
"confidenceScore": 20,
"confidence": "LOW",
"isVerified": false,
"attributionReason": "Behavioral heuristics were inconclusive.",
"attributionReasonCode": "INCONCLUSIVE_BEHAVIORAL_HEURISTICS",
"agenticBehaviour": {
"detected": false,
"confidenceScore": 0,
"confidence": "LOW",
"isVerified": false,
"attributionReason": null,
"attributionReasonCode": null
},
"riskScore": null,
"auditLogId": "7b181f74-6c8f-4c62-8e87-67a8d0797dd3",
"entityInfo": null
}
Example: ERC-8004 Registered Agent
The wallet classification and agentic attribution remain independent. This example has insufficient evidence for a custody classification but is deterministically identified as an ERC-8004 agent.
{
"id": "4d6ac747-12d7-4a91-a48b-9df0d55cf671",
"address": "0x1111111111111111111111111111111111111111",
"blockchain": "Ethereum",
"walletType": "UNKNOWN",
"confidenceScore": 20,
"confidence": "LOW",
"isVerified": false,
"attributionReason": "Behavioral heuristics were inconclusive.",
"attributionReasonCode": "INCONCLUSIVE_BEHAVIORAL_HEURISTICS",
"agenticBehaviour": {
"detected": true,
"confidenceScore": 100,
"confidence": "HIGH",
"isVerified": true,
"attributionReason": "Wallet is registered as an ERC-8004 agent.",
"attributionReasonCode": "DETECTED_VIA_ERC8004"
},
"riskScore": null,
"auditLogId": "4d6ac747-12d7-4a91-a48b-9df0d55cf671",
"entityInfo": null
}