For cryptocurrency transactions, Didit automatically screens wallet addresses and transaction hashes against blockchain analytics providers during transaction creation. Screening runs server-side — no additional API calls are needed from your side.
How screening triggers AML blockchain screening runs automatically when both conditions are met:
The transaction has currency_kind: "crypto" in its transaction details
Transaction monitoring is enabled in your application settings
You can override this per transaction by setting include_aml_screening to false in the create transaction payload.
Inbound vs outbound Direction What is screened Purpose Inbound (deposits)Transaction hash for full source-of-funds tracing, or the counterparty’s sender wallet address as a fallback Assess where the funds came from before crediting the user Outbound (withdrawals)Counterparty’s destination wallet address Assess the risk of the receiving address before funds leave
Supported providers Provider Status Managed pricing BYOK pricing Crystal Available $0.18/screening $0.02/screening Merkle Science Available $0.15/screening $0.02/screening Chainalysis Coming soon — $0.02/screening Elliptic Coming soon — $0.02/screening
Configure your preferred provider in Transactions > Settings > Provider Preferences in the Business Console .
With BYOK (Bring Your Own Key) pricing, you connect your existing provider API key and pay a reduced per-screening fee. This is useful if you already have a commercial agreement with a blockchain analytics provider.
Screening results Each screening produces a standardised result regardless of which provider is used.
Risk score and severity Every screened wallet or transaction receives:
Risk score (0–100) — higher scores indicate greater exposure to risky entitiesSeverity level — derived from the score: LOW, MEDIUM, HIGH, or CRITICAL
Source of funds analysis A percentage breakdown of where the funds originated, categorised by entity type:
Category Risk level Description SANCTIONEDCritical Entities on international sanctions lists (OFAC, EU, UN) TERRORIST_FINANCINGCritical Addresses linked to terrorist financing CHILD_EXPLOITATIONCritical Addresses linked to child exploitation material RANSOMWAREHigh Ransomware payment addresses STOLEN_FUNDSHigh Addresses associated with known theft or hacks DARKNET_MARKETHigh Darknet marketplace addresses MIXERHigh Mixing or tumbling services used to obscure fund origins SCAMHigh Known scam or fraud addresses HIGH_RISK_EXCHANGEMedium Exchanges with weak KYC/AML controls HIGH_RISK_JURISDICTIONMedium Entities in FATF-listed high-risk jurisdictions GAMBLING_UNLICENSEDMedium Unlicensed gambling platforms P2P_EXCHANGELow Peer-to-peer exchange services EXCHANGELow Regulated cryptocurrency exchanges UNNAMED_SERVICELow Unidentified services
Each entity in the breakdown includes the percentage of funds, received and sent amounts, and whether the connection is direct or indirect.
Counterparty connections A list of entities the wallet has transacted with, including:
Entity name and category
Direct vs. indirect connection (hop distance)
Received and sent amounts
Risk level per entity
Network graph A visual node-edge representation of the wallet’s transaction relationships:
Nodes represent wallets, exchanges, services, and other entitiesEdges represent transactions between nodes, with amounts and transaction hashesMetrics include graph-level statistics such as centrality and depth
The network graph is available in the Business Console as an interactive visualization.
Integration with rules Screening results feed directly into the rules engine . Didit includes preset rules that fire automatically based on screening data:
Preset rule Action Sanctions counterparty Immediate decline — any sanctions exposure Terrorist financing / child exploitation Immediate decline Darknet market exposure Add score + flag for review Mixer/obfuscation service exposure Add score + flag for review High-risk source of funds (>30%) Add score + flag for review Multiple risky counterparties Add score + flag for review Medium wallet risk score Add score + flag for review Screening pending Hold transaction until screening completes
After screening completes, Didit automatically re-evaluates all rules against the enriched transaction data and triggers any applicable webhooks.
Next steps
Submitting transactions How to submit transactions including crypto wallet details.
Rules & scoring How screening results feed into the rule engine.
Console guide Viewing AML analysis, source of funds, and network graphs in the console.
