> 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/de/api-documentation/introduction.md).

# Einführung

Mit der Phalcon Compliance REST API können Sie die Adressprüfung und Transaktionsüberwachung direkt in Ihre Anwendungen und Workflows integrieren. Ganz gleich, ob Sie vor der Verarbeitung einer Auszahlung eine einzelne Wallet prüfen oder Transaktionen über mehrere Chains hinweg kontinuierlich überwachen möchten: Die API bietet programmgesteuerten Zugriff auf dieselben Risikoanalysen, die auch im Phalcon Compliance-Dashboard verfügbar sind.

## Was Sie tun können

### Adressprüfung

Prüfen Sie Blockchain-Adressen mit der Risiko-Engine, um sanktionierte Entitäten, Risiken durch Kontakte mit illegalen Geldern und andere Compliance-Risiken zu identifizieren.

| Endpunkt                                                                                                                                                      | Beschreibung                                                              |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [`POST /address/screen`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/address-screening/screen-a-single-address.md)                      | Eine einzelne Adresse prüfen und Risikoergebnisse abrufen                 |
| [`POST /addresses/screen`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/address-screening/batch-screen-addresses.md)                     | Bis zu 100 Adressen in einer Anfrage prüfen                               |
| [`GET /addresses/details/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/address-screening/get-an-address-detail.md) | Eine detaillierte Risikoaufschlüsselung für eine geprüfte Adresse abrufen |
| [`GET /addresses/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/address-screening/get-a-task-result.md)           | Die Ergebnisse einer asynchronen Prüfaufgabe abfragen                     |
| [`PUT /addresses/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/address-screening/update-an-address-info.md)        | Benutzerdefinierte Labels oder Notizen für eine Adresse aktualisieren     |

### Transaktionsprüfung

Überwachen Sie das Risiko einer einzelnen Transaktion oder einer Gruppe von Transaktionen einschließlich aller zugehörigen Transfers.

| Endpunkt                                                                                                                                                                     | Beschreibung                                                          |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| [`POST /transaction/screen`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/transaction-screening/screen-a-single-transaction.md)                         | Eine einzelne Transaktion prüfen                                      |
| [`POST /transactions/screen`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/transaction-screening/batch-screen-transactions.md)                          | Bis zu 100 Transaktionen in einer Anfrage prüfen                      |
| [`GET /transactions/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/transaction-screening/get-a-task-result.md)                   | Die Ergebnisse einer asynchronen Prüfaufgabe abfragen                 |
| [`GET /transactions/details/{transfer_id}`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/transaction-screening/get-a-transfer-detail.md)                | Detaillierte Risikoinformationen zu einem bestimmten Transfer abrufen |
| [`GET /transactions/transfers/{chain_id}/{hash}`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/transaction-screening/get-transfers-of-a-transaction.md) | Alle Transfers innerhalb einer Transaktion auflisten                  |

### Kundenverwaltung

Verknüpfen Sie geprüfte Adressen und Transaktionen mit bestimmten Kunden, um die Compliance-Überwachung übersichtlich zu organisieren.

| Endpunkt                                                                                                                                                     | Beschreibung                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
| [`GET /customers/details/{customer_id}`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/customer/get-a-customer-detail.md)                | Details zu einem bestimmten Kunden abrufen |
| [`POST /customers/{customer_id}/addresses`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/customer/add-addresses-to-a-customer.md)       | Adressen zu einem Kunden hinzufügen        |
| [`POST /customers/{customer_id}/transactions`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/customer/add-transactions-to-a-customer.md) | Transaktionen zu einem Kunden hinzufügen   |

### Verwaltung von Blacklists und Whitelists

Verwalten Sie benutzerdefinierte Adresslisten, um Adressen bei der Prüfung automatisch zu markieren oder zu überspringen.

| Endpunkt                                                                                                                                                         | Beschreibung                         |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| [`POST /blacklists/add`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/blacklist-whitelist-management/add-addresses-to-blacklist.md)         | Adressen zur Blacklist hinzufügen    |
| [`POST /blacklists/remove`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/blacklist-whitelist-management/remove-addresses-from-blacklist.md) | Adressen aus der Blacklist entfernen |
| [`POST /whitelists/add`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/blacklist-whitelist-management/add-addresses-to-whitelist.md)         | Adressen zur Whitelist hinzufügen    |
| [`POST /whitelists/remove`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/blacklist-whitelist-management/remove-addresses-from-whitelist.md) | Adressen aus der Whitelist entfernen |

### Kontoverwaltung

Fragen Sie die API-Nutzung und das Kontingent Ihres Projekts ab.

| Endpunkt                                                                                                                                      | Beschreibung                            |
| --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| [`GET /account/usage/screening`](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/account-management/get-screening-usage.md) | Statistiken zur Prüfungsnutzung abrufen |

## Schnellstart

**1. API-Schlüssel abrufen** — Rufen Sie in Ihrem Projektarbeitsbereich **System → API** auf und klicken Sie dann auf **Schlüssel generieren**.

**2. Ihre erste Anfrage senden:**

```bash
curl -X POST {BASE_URL}/address/screen \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "chainId": 1,
    "address": "0x..."
  }'
```

**3. Antwort prüfen** — Wenn die Prüfung innerhalb von 10 Sekunden abgeschlossen wird, erhalten Sie das Ergebnis direkt. Andernfalls erhalten Sie eine Task ID, deren Status Sie über `/addresses/screen/tasks/{task_id}` (oder bei der Transaktionsprüfung über `/transactions/screen/tasks/{task_id}`) abfragen können.

## Wichtige Konzepte

* **Risiko-Engines** — Jede Prüfung wird mit mehreren Risiko-Engines durchgeführt. Die Ergebnisse enthalten den Risikoscore und die Risikoindikatoren für jede Engine. Eine vollständige Liste aller möglichen Indikatoren finden Sie unter [Liste der Risikoindikatoren](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/introduction/risk-indicator-list.md).
* **Asynchrone Aufgaben** — Gruppenanfragen und langsamere Prüfungen geben eine Task ID zurück. Sobald die Ergebnisse vorliegen, können Sie sie über `/addresses/screen/tasks/{task_id}` oder `/transactions/screen/tasks/{task_id}` abrufen.
* **Chain ID** — Jede unterstützte Blockchain hat eine numerische Chain ID (zum Beispiel Ethereum = `1`, Bitcoin = `-1`). Die vollständige Liste finden Sie unter [Unterstützte Chains](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/introduction/supported-chains.md).

## Nächste Schritte

* [Authentifizierung](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/introduction/authentication.md) — So authentifizieren Sie Ihre API-Anfragen
* [Ratenlimits](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/introduction/rate-limits.md) — Standardratenlimits für jeden Endpunkt
* [Unterstützte Chains](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/introduction/supported-chains.md) — Chains und ihre IDs
* [Änderungsprotokoll](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/introduction/changelog.md) — Aktuelle API-Updates
