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

# 소개

Phalcon Compliance REST API를 사용하면 주소 스크리닝과 트랜잭션 모니터링을 애플리케이션 및 워크플로에 직접 통합할 수 있습니다. 출금을 처리하기 전에 개별 지갑을 확인하거나 여러 체인에서 트랜잭션을 지속적으로 모니터링해야 하는 경우, API를 통해 Phalcon Compliance 대시보드에서 제공되는 것과 동일한 위험 인텔리전스에 프로그래밍 방식으로 액세스할 수 있습니다.

## 할 수 있는 작업

### 주소 스크리닝

블록체인 주소를 위험 엔진과 대조해 제재 대상 기관, 불법 자금에 대한 노출 및 기타 컴플라이언스 위험을 식별합니다.

| 엔드포인트                                                                                                                                                            | 설명                             |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| [`POST /address/screen`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/address-screening/screen-a-single-address.md)                      | 단일 주소를 스크리닝하고 위험 결과를 확인합니다     |
| [`POST /addresses/screen`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/address-screening/batch-screen-addresses.md)                     | 한 번의 요청으로 최대 100개의 주소를 스크리닝합니다 |
| [`GET /addresses/details/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/address-screening/get-an-address-detail.md) | 스크리닝한 주소의 상세한 위험 내역을 조회합니다     |
| [`GET /addresses/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/address-screening/get-a-task-result.md)           | 비동기 스크리닝 작업의 결과를 확인합니다         |
| [`PUT /addresses/{chain_id}/{address}`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/address-screening/update-an-address-info.md)        | 주소의 사용자 지정 라벨 또는 메모를 업데이트합니다   |

### 트랜잭션 스크리닝

관련된 모든 이체를 포함해 개별 트랜잭션 또는 트랜잭션 일괄의 위험 노출을 모니터링합니다.

| 엔드포인트                                                                                                                                                                           | 설명                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| [`POST /transaction/screen`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/transaction-screening/screen-a-single-transaction.md)                         | 단일 트랜잭션을 스크리닝합니다                 |
| [`POST /transactions/screen`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/transaction-screening/batch-screen-transactions.md)                          | 한 번의 요청으로 최대 100개의 트랜잭션을 스크리닝합니다 |
| [`GET /transactions/screen/tasks/{task_id}`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/transaction-screening/get-a-task-result.md)                   | 비동기 스크리닝 작업의 결과를 확인합니다           |
| [`GET /transactions/details/{transfer_id}`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/transaction-screening/get-a-transfer-detail.md)                | 특정 이체의 상세 위험 정보를 확인합니다           |
| [`GET /transactions/transfers/{chain_id}/{hash}`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/transaction-screening/get-transfers-of-a-transaction.md) | 트랜잭션 내 모든 이체를 나열합니다              |

### 고객 관리

체계적인 컴플라이언스 추적을 위해 스크리닝한 주소와 트랜잭션을 특정 고객에 연결합니다.

| 엔드포인트                                                                                                                                                           | 설명                  |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| [`GET /customers/details/{customer_id}`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/customer/get-a-customer-detail.md)                | 특정 고객의 세부 정보를 확인합니다 |
| [`POST /customers/{customer_id}/addresses`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/customer/add-addresses-to-a-customer.md)       | 고객에게 주소를 추가합니다      |
| [`POST /customers/{customer_id}/transactions`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/customer/add-transactions-to-a-customer.md) | 고객에게 트랜잭션을 추가합니다    |

### 블랙리스트/화이트리스트 관리

사용자 지정 주소 목록을 관리하여 스크리닝 중 주소에 자동으로 플래그를 지정하거나 스크리닝을 건너뜁니다.

| 엔드포인트                                                                                                                                                               | 설명                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| [`POST /blacklists/add`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/blacklist-whitelist-management/add-addresses-to-blacklist.md)         | 블랙리스트에 주소를 추가합니다   |
| [`POST /blacklists/remove`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/blacklist-whitelist-management/remove-addresses-from-blacklist.md) | 블랙리스트에서 주소를 제거합니다  |
| [`POST /whitelists/add`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/blacklist-whitelist-management/add-addresses-to-whitelist.md)         | 화이트리스트에 주소를 추가합니다  |
| [`POST /whitelists/remove`](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/blacklist-whitelist-management/remove-addresses-from-whitelist.md) | 화이트리스트에서 주소를 제거합니다 |

### 계정 관리

프로젝트의 API 사용량과 할당량을 조회합니다.

| 엔드포인트                                                                                                                                            | 설명                |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------- |
| [`GET /account/usage/screening`](https://docs.compliance.phalcon.blocksec.com/ko-kr/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 '{
    "chainId": 1,
    "address": "0x..."
  }'
```

**3. 응답 확인하기** — 스크리닝이 10초 이내에 완료되면 결과를 바로 받습니다. 그렇지 않으면 `/addresses/screen/tasks/{task_id}`(트랜잭션 스크리닝의 경우 `/transactions/screen/tasks/{task_id}`)를 통해 결과를 확인할 수 있는 Task ID를 받습니다.

## 주요 개념

* **위험 엔진** — 각 스크리닝은 여러 위험 엔진을 대상으로 실행됩니다. 결과에는 각 엔진의 위험 점수와 위험 지표가 포함됩니다. 가능한 모든 지표는 [위험 지표 목록](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/introduction/risk-indicator-list.md)을 참조하세요.
* **비동기 작업** — 일괄 요청 및 처리 시간이 긴 스크리닝은 Task ID를 반환합니다. 결과가 준비되면 `/addresses/screen/tasks/{task_id}` 또는 `/transactions/screen/tasks/{task_id}`를 사용해 조회합니다.
* **체인 ID** — 지원되는 각 블록체인에는 숫자 체인 ID가 있습니다(예: Ethereum = `1`, Bitcoin = `-1`). 전체 목록은 [지원되는 체인](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/introduction/supported-chains.md)을 참조하세요.

## 다음 단계

* [인증](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/introduction/authentication.md) — API 요청을 인증하는 방법
* [요청 속도 제한](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/introduction/rate-limits.md) — 각 엔드포인트의 기본 요청 속도 제한
* [지원되는 체인](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/introduction/supported-chains.md) — 체인 및 해당 ID
* [변경 로그](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/introduction/changelog.md) — 최근 API 업데이트
