Chainalysis Alerts

If your organization uses Chainalysis for blockchain monitoring, you can add their alerts to the Unit21 system, and even incorporate these alerts into new U21 rules. Alerts can be resolved both in the Unit21 or the Chainalysis system (they are linked together).

Prerequisite: A Chainalysis Account and Key

To use this feature, your organization needs to have a Chainalysis account. Then:

  1. Log in to the dashboard.
  2. Go to User Settings, then the Verifications tab.
  1. Add the Chainalysis key CHAINALYSIS_API_TOKEN:
53445344 53445344 53445344
  1. Add the Chainalysis URL CHAINALYSIS_API_URL.
  1. Contact your Unit21 representative to let them know you are ready for the Chainalysis integration. You will need to share your Chainalysis credentials with Unit21

The Unit21 developer team will then configure your account to receive alerts from Chainalysis. Every few hours, we will call the Chainalysis API on your behalf and load Chainalysis alerts into Unit21 as Alert.Type='CHAINALYSIS' (don't forget, other alert types are always KYC or TM).

Alerts will appear in Unit21 system with source = EXTERNAL. Information is polled from Chainalysis every hour.

They will contain the following information:

Unit21 Alert details:

Chainalysis Alert details:

Rule triggered

Alert ID

Flagged at


Total flagged USD



User ID





Transaction hash

Created at


Event time

Alert status

Exposure type

Rule threshold min

Rule threshold max

Transaction hash

Transaction index

Transfer reference


Transfer output address (for peer-to-peer transactions)

  1. Send in the Chainalysis transaction hash when using the /events API:
transaction_data['transaction_hash'] = "af830da0919f9d3ebbc4130404677a85c9db11e9046b69e2ed90db86f6e0529e"

When sending transactional data using our events API, you must send the transaction hash via the transaction_hash field.

     "general_data": {
          "event_type": "transaction",
          "event_id": "txn-14565-dgfhop",
          "event_time": 1623365011
     "transaction_data": {
          "amount": 121,
          "transaction_hash": "af830da0919f9d3ebbc4130404677a85c9db11e9046b69e2ed90db86f6e0529e"
     "options": {
          "monitor": true,
          "upsert_on_conflict": true

How to make a Chainalysis rule

  1. Log in to the U21 dashboard.
  2. Go to Detection Models, then click Create a Scenario Model
  1. Select Chainalysis Alert - Risk levels:
  1. Configure your model (rule). See the Scenario Models section for more information.

Chainalysis alerts

When Chainalysis and Unit21 are synched, you will receive alerts:


You can use the link in the alert to view the alert in Chainalysis while on the alert detail page:

41584158 41604160

If you resolve the alert on Chainalysis, it will appear on Unit21:


and vice versa:


The link between the alert in Unit21 and Chanalysis is bidirectional.

Did this page help you?