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

# Chainalysis Sanctions Integration

Streamline your compliance operations by automating real-time blockchain address screening with B3OS and Chainalysis Sanctions. Seamlessly integrate reg...

![Chainalysis Sanctions logo](https://ai-icon.b3.fun/logo/chainalysis-sanctions) Integration available

Streamline your compliance operations by automating real-time blockchain address screening with B3OS and Chainalysis Sanctions. Seamlessly integrate regulatory checks into your existing workflows to mitigate risk and ensure institutional-grade security without manual intervention.


**[Public page](https://b3os.org/integrations/app/chainalysis-sanctions)**

Open the user-facing integration overview for examples, templates, and sharing.
  **[Action reference](/actions/reference)**

Schema-level references for executable actions and test payloads.
  **[Trigger reference](/actions/trigger-reference)**

Event and schedule triggers that can start B3OS workflows.

## Build With Chainalysis Sanctions

Use Chainalysis Sanctions when a workflow needs to call Screen Address for Sanctions or related Chainalysis Sanctions operations from a typed B3OS action. Start in the visual editor to connect an account, then use the references below for payload shape, required fields, and API testing.

## Available Actions

| Action | ID | Connector | Required fields |
| --- | --- | --- | --- |
| ![Screen Address for Sanctions logo](https://ai-icon.b3.fun/logo/chainalysis-sanctions) [Screen Address for Sanctions](/actions/reference/generated/chainalysis-sanctions-check-address) | `chainalysis-sanctions-check-address` | ![chainalysis-sanctions logo](https://ai-icon.b3.fun/logo/chainalysis-sanctions) `chainalysis-sanctions` | `address` |


## Available Triggers

No trigger references are published for this integration yet.


## Common Use Cases

**Automated Compliance Onboarding**

Automatically screen new user wallet addresses against global sanctions lists during the KYC/AML onboarding process to prevent high-risk actors from accessing your platform.
  **Real-Time Transaction Monitoring**

Integrate screening into your transaction pipeline to instantly validate outgoing or incoming transfers, automatically flagging or halting any movement involving sanctioned entities.
  **Institutional Risk Management**

Enhance your institutional custody workflows by adding a mandatory Chainalysis Sanctions check before any large-scale asset movements are finalized.
  **Automated Regulatory Reporting**

Combine screening results with B3OS logging to automatically generate audit trails and compliance reports whenever a flagged address is detected in your ecosystem.

## Connector Notes

- Create the connector from a trusted B3OS organization before publishing workflows that call external accounts.
- Keep OAuth tokens, API keys, bot tokens, channel IDs, and account IDs in connector settings or workflow props, not in reusable public template text.
- Test with the visual editor or `POST /v1/actions/{type}/test` before routing production traffic.

## Related Templates

No public templates are linked to this integration yet.

## FAQ

**How does the Chainalysis Sanctions integration work within B3OS?**

B3OS uses the Chainalysis Sanctions Screening API to automatically cross-reference blockchain addresses against global sanctions lists like OFAC, EU, and UN. You can trigger this action as part of a larger automated workflow whenever a new transaction or address is detected.
  **What happens if I don't provide a connector for the Chainalysis API?**

If no specific connector is attached within your B3OS workflow, the system is designed to automatically fall back to the CHAINALYSIS_SANCTIONS_API_KEY environment variable to ensure uninterrupted service.
  **Which sanctions lists are covered by this integration?**

The integration screens addresses against major international regulatory lists, including OFAC (US), the EU sanctions list, UN sanctions, and other critical global watchlists provided by Chainalysis.
  **Can I automate actions based on the screening results?**

Yes. You can build conditional logic in B3OS so that if an address is flagged by the Chainalysis Sanctions API, the workflow can automatically freeze a transaction, alert your compliance team, or block a user account.
  **Is this integration suitable for high-volume crypto exchanges?**

Absolutely. By using B3OS to automate the Chainalysis Sanctions API, exchanges can handle massive transaction volumes with sub-second screening latency, ensuring compliance at scale.