> ## Documentation Index
> Fetch the complete documentation index at: https://developer.verilock.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Chainalysis

> Screen cryptocurrency wallets for risk with Chainalysis KYT.

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

<Steps>
  <Step title="Obtain a Chainalysis API Key">
    Log in to your [Chainalysis Reactor](https://reactor.chainalysis.com) account. Navigate to **Settings > API Keys** and create a new key with KYT access.
  </Step>

  <Step title="Configure in Verilock">
    Go to **Dashboard > Settings > Integrations > Chainalysis** and enter:

    * **API Key**: Your Chainalysis KYT API key
    * **Environment**: `production` or `sandbox`
  </Step>

  <Step title="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.
  </Step>

  <Step title="Test Connection">
    Click **Test Connection** to verify API access. Verilock will send a test address to the Chainalysis sandbox.
  </Step>
</Steps>

## 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 |

<Info>
  Network support depends on your Chainalysis KYT plan. Contact Chainalysis to enable additional networks.
</Info>

## 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     |

<Tip>
  You can customize the score thresholds and default actions from **Dashboard > Settings > Risk Rules > Wallet Screening**.
</Tip>

## 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:

```json theme={null}
{
  "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"]` |

<Warning>
  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.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid API key">
    Verify your Chainalysis API key has KYT access enabled. Sandbox and production keys are not interchangeable.
  </Accordion>

  <Accordion title="Unsupported network error">
    Ensure the requested network is enabled on your Chainalysis plan and is in the supported networks list above.
  </Accordion>

  <Accordion title="Timeout errors">
    Chainalysis screenings have a 30-second timeout. If timeouts persist, check your Chainalysis plan's rate limits or contact Chainalysis support.
  </Accordion>
</AccordionGroup>