The Chainalysis integration connects your Chainalysis account directly to the Corsa platform. All Know Your Transaction (KYT) alerts are automatically synced from Chainalysis into your Corsa dashboard - and any updates your team makes in Corsa (such as status changes, notes, or resolutions) are instantly pushed back to Chainalysis.
This ensures a seamless, bi-directional workflow, so your compliance team always works with the most up-to-date information in both platforms.
How It Works
- Secure Connection - You securely link your Chainalysis KYT account to Corsa. This is a one-time setup. All credentials are fully encrypted and securely stored.
- Automatic Two-Way Syncing - Every few minutes, Corsa automatically checks your Chainalysis KYT account for new or updated alerts and pulls them into your dashboard. Updates made in Corsa are instantly synced back.
- Smart Organization & Prioritization - Using a rules engine, Corsa reads details from each alert (risk score, sanction exposure, transaction type) and assigns the correct Priority and Category automatically.
- Building the Full Picture - Corsa links each incoming alert to the relevant customer profile, wallet, and transaction history already in the platform.
- Keeping Everything Up-to-Date - Updates and new alerts sync bi-directionally. No duplicates.
Prerequisites
- A KYT Chainalysis account with permission to generate API credentials.
- Owner access to the Corsa application.
Setting Up the Chainalysis Integration
- Log in to Corsa.
- Go to Developers Hub → Integrations.
- Click Configure on the Chainalysis card.
- Create an API Key in the Chainalysis KYT API keys page.
- Enter the credentials into Corsa.
- Configure the Polling Interval (how frequently Corsa fetches new alerts).
If the configuration was successful, you should see the integration in an enabled status.
Linking Chainalysis Users to Clients
When creating a new client via the Corsa API, include the chainalysisUserId field. See the API Reference.
Inside the client profile in Corsa, you will see:
- All related Chainalysis alerts correlated to this customer.
- External Providers section linking to Chainalysis.
Linking Chainalysis Transfers to Transactions
When creating a new transaction via the Corsa API, include the chainalysisTransactionId field. See the API Reference.
Alert Mapping
Category Mapping
| Priority | Category | Condition |
|---|
| 1 | TRANSACTION_MONITORING | All Chainalysis alerts are considered transaction monitoring alerts. |
Priority Mapping
| Priority | Level | Condition |
|---|
| 1 | HIGH | Chainalysis alert level is HIGH or SEVERE. |
| 2 | MEDIUM | Chainalysis alert level is MEDIUM. |
| 3 | LOW | Chainalysis alert level is LOW. |
Status Mapping
| Priority | Status | Condition |
|---|
| 4 | ESCALATED + Case creation | Chainalysis alert is in status Flagged. |
| 3 | RESOLVED | Chainalysis alert is in status Dismissed or NO_REVIEW. |
| 2 | IN_REVIEW | Chainalysis alert is in status In Review. |
| 1 | NEW | All other cases. |
Status mapping is bi-directional. If an alert status is updated in Corsa, it will update the status in Chainalysis as well.
Corsa offers native integrations with leading compliance, blockchain analytics, and custody providers. See all integrations or schedule a demo to see how Corsa fits into your stack. 
