> 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`](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/address-screening/screen-a-single-address.md)                      | 1つのアドレスをスクリーニングし、リスク結果を取得します    |
| [`POST /addresses/screen`](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/address-screening/batch-screen-addresses.md)                     | 1回のリクエストで最大100件のアドレスをスクリーニングします |
| [`GET /addresses/details/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/address-screening/get-an-address-detail.md) | スクリーニング済みアドレスの詳細なリスク内訳を取得します    |
| [`GET /addresses/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/address-screening/get-a-task-result.md)           | 非同期スクリーニングタスクの結果をポーリングします       |
| [`PUT /addresses/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/address-screening/update-an-address-info.md)        | アドレスのカスタムラベルまたはメモを更新します         |

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

個別または一括のトランザクションのリスクエクスポージャーを、関連するすべての送金を含めて監視します。

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

### 顧客管理

スクリーニング済みのアドレスとトランザクションを特定の顧客に紐付け、コンプライアンスの追跡を整理します。

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

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

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

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

### アカウント管理

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

| エンドポイント                                                                                                                                       | 説明                   |
| --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| [`GET /account/usage/screening`](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/account-management/get-screening-usage.md) | スクリーニングの使用状況統計を取得します |

## クイックスタート

**1. APIキーを取得する** — プロジェクトのワークスペースで、**システム → API**に移動し、**キーを生成**をクリックします。

**2. 最初のリクエストを送信する:**

```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. レスポンスを確認する** — スクリーニングが10秒以内に完了した場合、結果が直接返されます。それ以外の場合は、`/addresses/screen/tasks/{task_id}`（トランザクションスクリーニングの場合は`/transactions/screen/tasks/{task_id}`）を使ってポーリングするためのTask IDが返されます。

## 主な概念

* **リスクエンジン** — 各スクリーニングは複数のリスクエンジンを対象に実行されます。結果には、各エンジンのリスクスコアとリスクインジケーターが含まれます。すべてのインジケーターについては、[リスクインジケーター一覧](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/introduction/risk-indicator-list.md)をご覧ください。
* **非同期タスク** — 一括リクエストや処理に時間のかかるスクリーニングでは、Task IDが返されます。結果の準備ができたら、`/addresses/screen/tasks/{task_id}`または`/transactions/screen/tasks/{task_id}`を使って取得します。
* **Chain ID** — 対応する各ブロックチェーンには数値のチェーンIDがあります（例: Ethereum = `1`、Bitcoin = `-1`）。一覧については[対応チェーン](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/introduction/supported-chains.md)をご覧ください。

## 次のステップ

* [認証](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/introduction/authentication.md) — APIリクエストの認証方法
* [レート制限](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/introduction/rate-limits.md) — 各エンドポイントのデフォルトのレート制限
* [対応チェーン](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/introduction/supported-chains.md) — チェーンとそのID
* [変更履歴](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/introduction/changelog.md) — 最近のAPI更新
