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

# はじめに

Phalcon Compliance REST APIを使用すると、アドレススクリーニングとトランザクション監視を直接アプリケーションとワークフローに統合できます。出金処理前に単一のウォレットをチェックする場合でも、複数のチェーン全体でトランザクションを継続的に監視する場合でも、APIはPhalcon Complianceダッシュボードで利用可能な同じリスク情報へのプログラマティックアクセスを提供します。

## できること

### アドレススクリーニング

リスクエンジンに対してブロックチェーンアドレスをスクリーニングし、制裁対象エンティティ、違法資金露出、およびその他のコンプライアンスリスクを特定します。

| エンドポイント                                                                                                           | 説明                          |
| ----------------------------------------------------------------------------------------------------------------- | --------------------------- |
| [`POST /address/screen`](/ja/api-documentation/address-screening/screen-a-single-address.md)                      | 単一アドレスをスクリーニングしてリスク結果を取得    |
| [`POST /addresses/screen`](/ja/api-documentation/address-screening/batch-screen-addresses.md)                     | 1つのリクエストで最大100のアドレスをスクリーニング |
| [`GET /addresses/details/{chain_id}/{address}`](/ja/api-documentation/address-screening/get-an-address-detail.md) | スクリーニング済みアドレスの詳細なリスク内訳を取得   |
| [`GET /addresses/screen/tasks/{task_id}`](/ja/api-documentation/address-screening/get-a-task-result.md)           | 非同期スクリーニングタスクの結果をポーリング      |
| [`PUT /addresses/{chain_id}/{address}`](/ja/api-documentation/address-screening/update-an-address-info.md)        | アドレスのカスタムラベルまたはメモを更新        |

### トランザクションスクリーニング

個別トランザクションまたはバッチを監視して、関連するすべての転送全体のリスク露出をモニタリングします。

| エンドポイント                                                                                                                          | 説明                              |
| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| [`POST /transaction/screen`](/ja/api-documentation/transaction-screening/screen-a-single-transaction.md)                         | 単一トランザクションをスクリーニング              |
| [`POST /transactions/screen`](/ja/api-documentation/transaction-screening/batch-screen-transactions.md)                          | 1つのリクエストで最大100のトランザクションをスクリーニング |
| [`GET /transactions/screen/tasks/{task_id}`](/ja/api-documentation/transaction-screening/get-a-task-result.md)                   | 非同期スクリーニングタスクの結果をポーリング          |
| [`GET /transactions/details/{transfer_id}`](/ja/api-documentation/transaction-screening/get-a-transfer-detail.md)                | 特定の転送の詳細なリスク情報を取得               |
| [`GET /transactions/transfers/{chain_id}/{hash}`](/ja/api-documentation/transaction-screening/get-transfers-of-a-transaction.md) | トランザクション内のすべての転送をリスト            |

### 顧客管理

スクリーニング済みアドレスとトランザクションを特定の顧客にリンクして、組織化されたコンプライアンストラッキングを実現します。

| エンドポイント                                                                                                          | 説明             |
| ---------------------------------------------------------------------------------------------------------------- | -------------- |
| [`GET /customers/details/{customer_id}`](/ja/api-documentation/customer/get-a-customer-detail.md)                | 特定の顧客の詳細を取得    |
| [`POST /customers/{customer_id}/addresses`](/ja/api-documentation/customer/add-addresses-to-a-customer.md)       | 顧客にアドレスを追加     |
| [`POST /customers/{customer_id}/transactions`](/ja/api-documentation/customer/add-transactions-to-a-customer.md) | 顧客にトランザクションを追加 |

### ブラックリスト / ホワイトリスト管理

カスタムアドレスリストを管理して、スクリーニング中にアドレスを自動的にフラグ付けまたはスキップします。

| エンドポイント                                                                                                              | 説明               |
| -------------------------------------------------------------------------------------------------------------------- | ---------------- |
| [`POST /blacklists/add`](/ja/api-documentation/blacklist-whitelist-management/add-addresses-to-blacklist.md)         | ブラックリストにアドレスを追加  |
| [`POST /blacklists/remove`](/ja/api-documentation/blacklist-whitelist-management/remove-addresses-from-blacklist.md) | ブラックリストからアドレスを削除 |
| [`POST /whitelists/add`](/ja/api-documentation/blacklist-whitelist-management/add-addresses-to-whitelist.md)         | ホワイトリストにアドレスを追加  |
| [`POST /whitelists/remove`](/ja/api-documentation/blacklist-whitelist-management/remove-addresses-from-whitelist.md) | ホワイトリストからアドレスを削除 |

### アカウント管理

プロジェクトのAPI使用状況とクォータを照会します。

| エンドポイント                                                                                           | 説明             |
| ------------------------------------------------------------------------------------------------- | -------------- |
| [`GET /account/usage/screening`](/ja/api-documentation/account-management/get-screening-usage.md) | スクリーニング使用統計を取得 |

## クイックスタート

**1. APIキーを取得** — プロジェクトワークスペースの **System → API** に移動し、**Generate Key** をクリックします。

**2. 最初のリクエストを作成:**

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

**3. レスポンスを確認** — スクリーニングが10秒以内に完了した場合、結果が直接返されます。それ以外の場合、`/task/result` でポーリングするためのTask IDを受け取ります。

## 主な概念

* **リスクエンジン** — 各スクリーニングは複数のリスクエンジンに対して実行されます。結果にはエンジンごとのリスクスコアとリスク指標が含まれます。すべての可能な指標については、[List of Risk Indicators](/ja/api-documentation/introduction/risk-indicator-list.md) を参照してください。
* **非同期タスク** — バッチリクエストと低速スクリーニングはTask IDを返します。結果の準備ができたら `/task/result` エンドポイントを使用して結果を取得します。
* **Chain ID** — サポートされている各ブロックチェーンには数値のchain IDがあります（例：Ethereum = `1`、Bitcoin = `-1`）。完全なリストについては、[Supported Chains](/ja/api-documentation/introduction/supported-chains.md) を参照してください。

## 次のステップ

* [Authentication](/ja/api-documentation/introduction/authentication.md) — APIリクエストの認証方法
* [Rate Limits](/ja/api-documentation/introduction/rate-limits.md) — エンドポイントごとのデフォルトレート制限
* [Supported Chains](/ja/api-documentation/introduction/supported-chains.md) — チェーンとそのID
* [Changelog](/ja/api-documentation/introduction/changelog.md) — 最近のAPI更新