> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/manual/screening/addresses.md).

# Address Screening

Addresses represent blockchain wallets or contracts that users screen for risk. Typically, these are customer addresses that interact with your platform. Proactive screening enables timely identification of high-risk entities, allowing risk mitigation measures to be taken.

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-04e46a8b3ec0cb32766d5a1821a1568f342df773%2Fimage.png?alt=media" alt="Addresses page with screening, export, filters, and risk summaries"><figcaption><p>Addresses</p></figcaption></figure>

### Labels

Labels provide human-readable identifiers for addresses and are sourced from BlockSec's verified address database. Labels are system-generated and cannot be edited by users.

### Tags

Tags classify addresses by attributes or behavior (for example, deposit address or frozen).

* System tags (immutable):
  * Sourced from the BlockSec database (for example, sanctioned or mixer).
  * Cannot be edited or deleted.
* Custom tags (user-defined):
  * Add internal classifications (for example, VIP customer or pending review).
  * Can be freely edited/deleted, but the total number of tags per address must be ≤5 (system tags + custom tags).

### Notes

Users can add notes to any address to record additional context or observations. Notes are visible to all team members and recorded in the address's audit logs.

## Screen Addresses

Methods:

* Screen a single address
* Batch screen via CSV

All addresses are automatically screened and displayed in the address list.

### Add a Single Address

To add a single address for import and screening:

* Enter the address to add. Phalcon will automatically retrieve data, including the chain, labels, and system tags.
* Select the target address for screening.

### Batch Screen via CSV

Users can also screen multiple addresses at once using a CSV file.

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-70ff2682ce6c6bed40ed2a3778f4d68d73e82cb3%2Fimage.png?alt=media" alt="Bulk address screening via CSV upload"><figcaption></figcaption></figure>

* Download the CSV template from the "Addresses" page.
* Upload up to 100 addresses per file.
* Complete the template:

| Field       | Description                                    |
| ----------- | ---------------------------------------------- |
| Chain       | Exact chain name in the template               |
| Address     | Blockchain address                             |
| Tag         | User-defined private tag (optional)            |
| Marker      | Custom tag (optional)                          |
| Customer ID | Existing or new customer identifier (optional) |

* Upload the CSV file.
* Review the import results in the pop-up window and ensure that each target address was imported successfully.

## Address List

Screened addresses are displayed in the address list, which includes information such as the address, risk summary, unresolved alerts, last screening time, tags, customer, and time added.

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-04e46a8b3ec0cb32766d5a1821a1568f342df773%2Fimage.png?alt=media" alt="Address list showing risk summaries, unresolved alerts, last screening time, notes, and tags"><figcaption></figcaption></figure>

## Export Addresses

You can export the address list as a CSV file by clicking the **Export** button on the address list page. This feature is available only to users on paid plans.

The exported CSV contains the following fields:

| Field                           | Description                                                                                                                                       | Example                                 |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| Chain                           | Blockchain network                                                                                                                                | ETH                                     |
| Address                         | Blockchain address                                                                                                                                |                                         |
| Risk Level                      | Current risk level of the address                                                                                                                 | Critical                                |
| Entity Risk Tags                | Risk tags associated with the address itself. Multiple tags are separated by `;`                                                                  | Scam; Blocked                           |
| Interaction Risk Breakdown      | Interaction risk indicators with detailed information. Format: `{Risk Tag}: {Direction} {Value} ({Ratio})`. Multiple entries are separated by `;` | No KYC Exchange: Incoming $0.02 (0.08%) |
| Entity Risk Details (JSON)      | Structured JSON for entity risk, intended for programmatic parsing                                                                                | See below                               |
| Interaction Risk Details (JSON) | Structured JSON for interaction risk, intended for programmatic parsing                                                                           | See below                               |
| Unresolved Alerts               | Number of unresolved alerts                                                                                                                       | 2                                       |
| Last Screening Time             | Time of the most recent screening                                                                                                                 | 2026-03-31 10:23:45                     |
| Label                           | System label                                                                                                                                      |                                         |
| Tags                            | System tags and user-defined tags                                                                                                                 | Scam; Blocked                           |
| Note                            | Note added by the user                                                                                                                            |                                         |
| Customer                        | Associated customer ID                                                                                                                            | Customer123                             |
| Added Time                      | Time when the address was added                                                                                                                   | 2026-03-30 15:20:11                     |

**Entity Risk Details (JSON) example:**

```json
[
  {
    "riskIndicator": "Scam",
    "riskLevel": "critical",
    "detail": "Fake_Phishing 123"
  },
  {
    "riskIndicator": "Blocked",
    "riskLevel": "high",
    "detail": "Blocked by USDT"
  }
]
```

**Interaction Risk Details (JSON) example:**

```json
[
  {
    "riskIndicator": "No KYC Exchange",
    "direction": "incoming",
    "minHop": 1,
    "exposureValue": 0.02,
    "exposurePercentage": 0.0008,
    "riskLevel": "medium"
  }
]
```

## Address Details Page

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-a0cd039608e0d65f7a05c675e342628a3065d320%2Fimage.png?alt=media" alt="Address details page overview"><figcaption></figcaption></figure>

Click an address in the **Address List** to open its **Details Page**.

At the top of the page, the address is displayed together with its entity and category.

### Basic Information

The **Basic Information** panel on the right displays the balance, total inflow, total outflow, label, tags, customer, screening count, and note.

### Screening Results

The screening results show the risk analysis from the most recent screening, organized as follows:

#### AI Risk Interpretation

Click **Ask AI** beside **Risk Summary**, **Entity Risk**, **Behavioral Risk**, or **Interaction Risk** to discuss the current screening result with Lumi. You can ask what a finding means, which evidence to review first, and what information is missing.

The Lumi panel shows the address and **Screened at** time used for the interpretation. Follow-up questions use the same screening result. Where available, evidence navigation buttons help you locate the supporting information on the page.

See [AI Risk Interpretation](https://docs.compliance.phalcon.blocksec.com/manual/screening/ai-risk-interpretation.md) for usage, allowances, and data limitations.

#### Risk Summary

A quick overview of all detected risks, divided into three categories: **Entity Risk**, **Interaction Risk**, and **Behavioral Risk**. Each category has a link that takes you to its detailed view.

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-e67efeebd64355544d7dd07d425131161fd68527%2Faddress-detail-risk-summary.png?alt=media" alt="Risk Summary showing Entity Risk, Interaction Risk, and Behavior Risk categories"><figcaption></figcaption></figure>

#### Entity Risk

Lists all risk attributes associated with the address itself, such as sanctions designations, involvement in known attacks, or blacklist/whitelist membership.

Each attribute is displayed as a row, including:

* **Risk Indicator** — The risk category (for example, sanctioned, attack, scam, or blacklist).
* **Details** — Specific risk details for the attribute. A single indicator may have multiple detail entries, displayed on separate rows.
* **Source** — For sanctioned addresses, the name of the sanctions list (for example, OFAC or NBCTF), with a link to the official record. For blacklisted/whitelisted addresses, a link to the list management page.
* **Triggered Rule** — The risk engine rule that was triggered. Hover over the rule icon to view the rule's configuration and risk level.

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-900cd1d3496253e7cfc569ffda0c7c32671fb831%2Faddress-entity-risk.png?alt=media" alt="Entity Risk showing Sanctioned and FATF High Risk Jurisdiction findings, source, and Triggered Rule links"><figcaption><p>A separate address example showing a sanctions source and jurisdiction details.</p></figcaption></figure>

#### Interaction Risk

Shows how the address interacts with risky counterparties through fund flows. This section includes:

* **Indicator Breakdown** — A bar chart comparing incoming and outgoing risk exposure across risk indicators (for example, sanctioned, mixer, or scam). Each bar distinguishes between direct (1-hop) and indirect (2+ hops) risk exposure, as well as whether the exposure triggered a rule. Hover over a bar to view a detailed breakdown; click it to filter the section below.
* **Risk Addresses** — A table of counterparty addresses associated with triggered risk indicators, showing the direction, minimum hop distance, and risk exposure amount. Expand any row to view detailed risk indicator information, including specific risk details and the sanctions list source, if applicable. You can filter by direction, indicator, or hop distance, and search by address or label. You can also export the risk address list as a CSV file.
* **Fund Flow** — A visual graph of fund flows between the screened address and risky counterparties. Filter by risk indicator or a specific address. Click **"View Detailed Fund Flow"** to open the full analysis in MetaSleuth.

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-b7ccfe55eae10a0caeb7837f35efa612dc9bbb15%2Faddress-interaction-risk.png?alt=media" alt="Interaction Risk showing Indicator Breakdown bar charts and Risk Addresses table"><figcaption></figcaption></figure>

{% hint style="info" %}
**Triggered vs. Not Triggered**: An indicator is "Triggered" when its risk exposure reaches the threshold of a rule in your active risk engine, generating an alert. "Not Triggered" means that risk exposure was detected but did not reach any threshold—it is provided for reference only.
{% endhint %}

#### Behavioral Risk

Lists suspicious transaction patterns detected for the address, such as large transfers, high-frequency transfers, or transit address behavior. Each row shows the behavior type, key metrics (for example, maximum value, matched events, or time window), and the triggered rule.

Hover over the information icon next to any behavior type to view an explanation of what it means and why it may be suspicious.

<figure><img src="https://1419887533-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPfx6yOSRmp0GCnHv5rhy%2Fuploads%2Fgit-blob-86558dc8f3671ba88e3a8fccb33b271b468674ac%2Faddress-behavior-risk.png?alt=media" alt="Behavior Risk showing Large Transfer, maximum value, matched events, and a Triggered Rule tooltip"><figcaption></figcaption></figure>

### Alerts, Audit Logs, and Comments

* **Alerts** — All alerts triggered by this address. Filter by status and click through to the Alert Center to view details.
* **Audit Logs** — System-generated records of screening events, risk level changes, and other activities.
* **Comments** — Team members can leave notes and collaborate on investigations.

### Available Actions

* **Monitor Now** — Enable continuous risk monitoring for the address. For details, see [Monitor](https://docs.compliance.phalcon.blocksec.com/manual/monitoring/monitor.md).
* **Re-screen Now** — Perform a new risk screening immediately. While re-screening is in progress, the previous results remain visible so you can continue your investigation.
* **Add to List** — Add the address to the blacklist or whitelist.
* **Share & Export** — Access sharing and report export actions, including a shareable screening result link and a **KYA Report**. Recipients can view the shared report without logging in.
* **Delete** — Remove the address from the system.

## Blacklisted Addresses

In the address list, click ***Add to List -> Blacklisted Address*** to blacklist an address. This action will:

* Automatically mark the address as **Critical Risk**.
* Exclude the address from standard risk engine screening.
* Mark any address that transacts directly with the blacklisted address as **Critical Risk**.

## Whitelisted Addresses

In the address list, click ***Add to List -> Whitelisted Address*** to whitelist an address. This action will:

* Automatically mark the address as **No Risk**.
* Exclude the address from standard risk engine screening.

## Delete Addresses

You can delete an address by clicking the ***Delete*** button in the last column of the address list or from the address details page. After an address is deleted, all alerts associated with it will expire.
