KYW response reference
Interpret custody classification, confidence, attribution, risk, and entity fields.
A fresh KYW check returns a classification and independent agentic signals. Risk and entity information depend on the available source data. Use the integration guide for a minimal request and routing decisions.
Response Model
| Field | Type | Description |
|---|---|---|
id | string | AML Check search history record ID. |
address | string | Wallet address that was classified. |
blockchain | string | Blockchain used for the classification. |
walletType | string | CUSTODIAL, NON_CUSTODIAL, or UNKNOWN. |
confidenceScore | number | Numeric confidence from 0 to 100. |
confidence | string | LOW, MEDIUM, or HIGH, derived from confidenceScore. |
isVerified | boolean | Whether the associated entity or wallet signal is verified. |
attributionReason | string or null | Human-readable explanation for the classification. |
attributionReasonCode | string or null | Machine-readable reason code. |
riskScore | number, object, or null | Risk score from the matched verification, directory entity, or analytics source when available. |
auditLogId | string | Audit ledger ID. This is the same AML history record ID as id. |
entityInfo | object or null | Entity details when KYW resolves the wallet to a known entity. |
agenticBehaviour | object | Independent agentic attribution result. It does not change walletType. |
agenticBehaviour fields:
| Field | Type | Description |
|---|---|---|
detected | boolean | Whether the available evidence crossed the agentic-detection threshold. |
confidenceScore | number | Agentic confidence from 0 to 100. A score of 100 is reserved for deterministic attribution. |
confidence | string | LOW, MEDIUM, or HIGH. |
isVerified | boolean | true only for deterministic attribution, currently an exact ERC-8004 match. Behavioral heuristics never set this to true. |
attributionReason | string or null | Human-readable explanation of the agentic result. |
attributionReasonCode | string or null | DETECTED_VIA_ERC8004, DETECTED_VIA_BEHAVIORAL_ANALYSIS, or null. |
walletType values:
| Value | Meaning |
|---|---|
CUSTODIAL | The wallet is likely controlled by a VASP, exchange, payment provider, bank, mining pool, ATM, or another custodial service. |
NON_CUSTODIAL | The wallet is likely controlled by an individual user, self-hosted wallet app, DeFi service, wallet verification record, or another non-custodial source. |
UNKNOWN | CryptoSwift could not classify the wallet with enough signal. Use your internal policy to decide whether to ask for more information, run wallet verification, or escalate. |
confidenceScore maps to confidence as follows:
| Score | Confidence |
|---|---|
0-33 | LOW |
34-66 | MEDIUM |
67-100 | HIGH |
Common attributionReasonCode values:
| Code | Meaning |
|---|---|
VERIFIED_SELF_HOSTED_WALLET | The wallet has a completed self-hosted wallet verification. |
REGISTERED_PLATFORM_TENANT_WALLET | The wallet matches a wallet registered by a CryptoSwift platform tenant. |
REGISTERED_PLATFORM_TENANT_WALLET_WITH_ASSET_HINT | The wallet matches a tenant wallet without blockchain metadata, and asset metadata suggests the requested blockchain. |
DETECTED_VIA_PARTNER_NETWORK | The wallet owner was identified through partner-network data. |
DETECTED_VIA_BLOCKCHAIN_ANALYTICS | Blockchain analytics identified an owner or entity type. |
KNOWN_SELF_HOSTED_WALLET_APP | The resolved entity is a known self-hosted wallet app. |
HEURISTIC_WEB3_AND_GENESIS_SIGNATURES | Behavioral heuristics indicate private-key ownership through Web3 activity or genesis funding patterns. |
HEURISTIC_AUTOMATED_PATTERNS | Behavioral heuristics indicate automated custodial wallet patterns. |
INCONCLUSIVE_BEHAVIORAL_HEURISTICS | Behavioral heuristics were inconclusive. |
These codes describe the root wallet classification. The nested agenticBehaviour.attributionReasonCode uses a separate namespace:
| Code | Meaning |
|---|---|
DETECTED_VIA_ERC8004 | The wallet exactly matches an ERC-8004 registered agent on the requested network. |
DETECTED_VIA_BEHAVIORAL_ANALYSIS | The wallet crossed the behavioral automation threshold. This result is not verified agent ownership. |
Entity Info
When KYW resolves the wallet to a known entity, entityInfo can include:
| Field | Description |
|---|---|
entityId | Public entity ID from the CryptoSwift entity directory. |
name / legalName | Entity display name and legal name. |
type | Entity type, such as exchange, wallet, bank, payment provider, DeFi service, or other directory type. |
isVerified | Whether CryptoSwift has verified the entity record. |
inNetwork | Whether the entity is in the CryptoSwift network. |
isRiskAssessed | Whether a risk assessment is available. |
isMicaCompliant | Whether the entity is marked as MiCA compliant. |
belongsToWarningList | Whether the entity belongs to a warning list. |
countries | Countries associated with the entity. |
riskAssessment | Risk assessment details when available. |
url, email, logo, notice | Public entity profile information when available. |