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.

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

Did this page help you?