Skip to main content
The Chainalysis integration enables cryptocurrency wallet screening as part of your verification flow. Wallets are evaluated against Chainalysis Know Your Transaction (KYT) data to produce a risk score and category classification.

​
Prerequisites

  • A Chainalysis KYT API key
  • Verilock Enterprise plan

​
Setup

1

Obtain a Chainalysis API Key

Log in to your Chainalysis Reactor account. Navigate to Settings > API Keys and create a new key with KYT access.
2

Configure in Verilock

Go to Dashboard > Settings > Integrations > Chainalysis and enter:
  • API Key: Your Chainalysis KYT API key
  • Environment: production or sandbox
3

Enable Wallet Screening

In your verification profile, enable the Wallet Screening step. You can require wallet screening for all sessions or only for specific applicant types.
4

Test Connection

Click Test Connection to verify API access. Verilock will send a test address to the Chainalysis sandbox.

​
Supported Networks

NetworkChain CodeStatus
BitcoinBTCSupported
EthereumETHSupported
PolygonMATICSupported
ArbitrumARBSupported
OptimismOPSupported
BNB Smart ChainBSCSupported
Avalanche C-ChainAVAXSupported
SolanaSOLSupported
TronTRXSupported
LitecoinLTCSupported
Bitcoin CashBCHSupported
Network support depends on your Chainalysis KYT plan. Contact Chainalysis to enable additional networks.

​
Risk Scoring

Chainalysis returns a risk score from 0 to 10 for each wallet address. Verilock maps these scores to four risk levels:
Score RangeRisk LevelDefault Action
0 - 2LowAuto-approve
3 - 5MediumFlag for review
6 - 7HighFlag for review
8 - 10SevereAuto-reject
You can customize the score thresholds and default actions from Dashboard > Settings > Risk Rules > Wallet Screening.

​
Risk Categories

Chainalysis classifies wallet exposure into categories:
CategoryDescription
darknet_marketInteractions with darknet marketplaces
ransomwareConnections to ransomware operations
stolen_fundsLinked to known theft events
sanctionsAssociated with sanctioned entities
mixerFunds routed through mixing services
scamConnection to known scam operations
terrorism_financingLinks to terrorism financing
fraud_shopAssociated with fraud-as-a-service platforms
child_exploitationConnection to CSAM-related activity

​
Wallet Screening Event

When a wallet is screened, Verilock emits a wallet.screened webhook event: 
{
  "event": "wallet.screened",
  "data": {
    "session_id": "ses_a1b2c3d4e5f6",
    "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
    "network": "ETH",
    "risk_score": 7.2,
    "risk_level": "high",
    "categories": ["mixer", "darknet_market"],
    "direct_exposure": 0.35,
    "indirect_exposure": 0.12,
    "decision": "review",
    "screened_at": "2026-03-15T14:30:00Z"
  },
  "timestamp": "2026-03-15T14:30:01Z",
  "webhook_id": "wh_evt_4c3b2a1d5e6f"
}

​
Configuration Options

SettingDescriptionDefault
auto_approve_thresholdMaximum score for auto-approval2
auto_reject_thresholdMinimum score for auto-rejection8
include_indirectInclude indirect exposure in scoringtrue
required_networksNetworks that must be screened["BTC", "ETH"]
Wallet screening adds approximately 2-5 seconds to session processing time depending on the Chainalysis API response time. Consider this when designing your user experience.

​
Troubleshooting

Verify your Chainalysis API key has KYT access enabled. Sandbox and production keys are not interchangeable.
Ensure the requested network is enabled on your Chainalysis plan and is in the supported networks list above.
Chainalysis screenings have a 30-second timeout. If timeouts persist, check your Chainalysis plan’s rate limits or contact Chainalysis support.