Skip to content

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
}

Next steps