Chainalysis

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

Obtain a Chainalysis API Key

Configure in Verilock

Go to Dashboard > Settings > Integrations > Chainalysis and enter:

API Key: Your Chainalysis KYT API key
Environment: production or sandbox

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.

Test Connection

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

Supported Networks

Network	Chain Code	Status
Bitcoin	`BTC`	Supported
Ethereum	`ETH`	Supported
Polygon	`MATIC`	Supported
Arbitrum	`ARB`	Supported
Optimism	`OP`	Supported
BNB Smart Chain	`BSC`	Supported
Avalanche C-Chain	`AVAX`	Supported
Solana	`SOL`	Supported
Tron	`TRX`	Supported
Litecoin	`LTC`	Supported
Bitcoin Cash	`BCH`	Supported

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 Range	Risk Level	Default Action
0 - 2	Low	Auto-approve
3 - 5	Medium	Flag for review
6 - 7	High	Flag for review
8 - 10	Severe	Auto-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:

Category	Description
`darknet_market`	Interactions with darknet marketplaces
`ransomware`	Connections to ransomware operations
`stolen_funds`	Linked to known theft events
`sanctions`	Associated with sanctioned entities
`mixer`	Funds routed through mixing services
`scam`	Connection to known scam operations
`terrorism_financing`	Links to terrorism financing
`fraud_shop`	Associated with fraud-as-a-service platforms
`child_exploitation`	Connection 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

Setting	Description	Default
`auto_approve_threshold`	Maximum score for auto-approval	`2`
`auto_reject_threshold`	Minimum score for auto-rejection	`8`
`include_indirect`	Include indirect exposure in scoring	`true`
`required_networks`	Networks 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

Invalid API key

Verify your Chainalysis API key has KYT access enabled. Sandbox and production keys are not interchangeable.

Unsupported network error

Ensure the requested network is enabled on your Chainalysis plan and is in the supported networks list above.

Timeout errors

Chainalysis screenings have a 30-second timeout. If timeouts persist, check your Chainalysis plan’s rate limits or contact Chainalysis support.

Getting Started

Integrations

Reference

AML Screening

Transaction Monitoring

Verification Enhancements

Data & Compliance

Decentralized Identity

Prerequisites

Setup

Supported Networks

Risk Scoring

Risk Categories

Wallet Screening Event

Configuration Options

Troubleshooting

​Prerequisites

​Setup

​Supported Networks

​Risk Scoring

​Risk Categories

​Wallet Screening Event

​Configuration Options

​Troubleshooting

Prerequisites

Setup

Supported Networks

Risk Scoring

Risk Categories

Wallet Screening Event

Configuration Options

Troubleshooting