> 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`](/ko-kr/api-documentation/address-screening/screen-a-single-address.md) | 단일 주소를 스크리닝하고 위험 결과를 얻습니다 | | [`POST /addresses/screen`](/ko-kr/api-documentation/address-screening/batch-screen-addresses.md) | 한 번의 요청으로 최대 100개 주소를 스크리닝합니다 | | [`GET /addresses/details/{chain_id}/{address}`](/ko-kr/api-documentation/address-screening/get-an-address-detail.md) | 스크리닝된 주소의 상세 위험 분석을 검색합니다 | | [`GET /addresses/screen/tasks/{task_id}`](/ko-kr/api-documentation/address-screening/get-a-task-result.md) | 비동기 스크리닝 작업의 결과를 폴링합니다 | | [`PUT /addresses/{chain_id}/{address}`](/ko-kr/api-documentation/address-screening/update-an-address-info.md) | 주소의 사용자 정의 레이블 또는 메모를 업데이트합니다 | ### 거래 스크리닝 개별 거래 또는 배치를 모니터링하여 관련된 모든 이전에서의 위험 노출을 확인합니다. | 엔드포인트 | 설명 | | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | | [`POST /transaction/screen`](/ko-kr/api-documentation/transaction-screening/screen-a-single-transaction.md) | 단일 거래를 스크리닝합니다 | | [`POST /transactions/screen`](/ko-kr/api-documentation/transaction-screening/batch-screen-transactions.md) | 한 번의 요청으로 최대 100개 거래를 스크리닝합니다 | | [`GET /transactions/screen/tasks/{task_id}`](/ko-kr/api-documentation/transaction-screening/get-a-task-result.md) | 비동기 스크리닝 작업의 결과를 폴링합니다 | | [`GET /transactions/details/{transfer_id}`](/ko-kr/api-documentation/transaction-screening/get-a-transfer-detail.md) | 특정 이전에 대한 상세 위험 정보를 얻습니다 | | [`GET /transactions/transfers/{chain_id}/{hash}`](/ko-kr/api-documentation/transaction-screening/get-transfers-of-a-transaction.md) | 거래 내의 모든 이전을 나열합니다 | ### 고객 관리 스크리닝된 주소 및 거래를 특정 고객과 연결하여 조직화된 컴플라이언스 추적을 수행합니다. | 엔드포인트 | 설명 | | ------------------------------------------------------------------------------------------------------------------- | ------------------- | | [`GET /customers/details/{customer_id}`](/ko-kr/api-documentation/customer/get-a-customer-detail.md) | 특정 고객의 세부 정보를 조회합니다 | | [`POST /customers/{customer_id}/addresses`](/ko-kr/api-documentation/customer/add-addresses-to-a-customer.md) | 고객에게 주소를 추가합니다 | | [`POST /customers/{customer_id}/transactions`](/ko-kr/api-documentation/customer/add-transactions-to-a-customer.md) | 고객에게 거래를 추가합니다 | ### 블랙리스트 / 화이트리스트 관리 사용자 정의 주소 목록을 관리하여 스크리닝 중에 주소를 자동으로 플래그하거나 건너뜁니다. | 엔드포인트 | 설명 | | ----------------------------------------------------------------------------------------------------------------------- | ------------------ | | [`POST /blacklists/add`](/ko-kr/api-documentation/blacklist-whitelist-management/add-addresses-to-blacklist.md) | 블랙리스트에 주소를 추가합니다 | | [`POST /blacklists/remove`](/ko-kr/api-documentation/blacklist-whitelist-management/remove-addresses-from-blacklist.md) | 블랙리스트에서 주소를 제거합니다 | | [`POST /whitelists/add`](/ko-kr/api-documentation/blacklist-whitelist-management/add-addresses-to-whitelist.md) | 화이트리스트에 주소를 추가합니다 | | [`POST /whitelists/remove`](/ko-kr/api-documentation/blacklist-whitelist-management/remove-addresses-from-whitelist.md) | 화이트리스트에서 주소를 제거합니다 | ### 계정 관리 프로젝트의 API 사용량 및 할당량을 조회합니다. | 엔드포인트 | 설명 | | ---------------------------------------------------------------------------------------------------- | ------------------ | | [`GET /account/usage/screening`](/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 '{ "chain_id": 1, "address": "0x..." }' ``` **3. 응답 확인** — 스크리닝이 10초 내에 완료되면 직접 결과를 받습니다. 그렇지 않으면 Task ID를 받으며 `/task/result`를 통해 폴링할 수 있습니다. ## 핵심 개념 * **위험 엔진** — 각 스크리닝은 여러 위험 엔진에 대해 실행됩니다. 결과에는 엔진별 위험 점수 및 위험 표시기가 포함됩니다. 모든 가능한 표시기에 대해 [위험 표시기 목록](/ko-kr/api-documentation/introduction/risk-indicator-list.md)을 참조하세요. * **비동기 작업** — 배치 요청 및 느린 스크리닝은 Task ID를 반환합니다. `/task/result` 엔드포인트를 사용하여 준비가 되면 결과를 검색합니다. * **체인 ID** — 지원되는 각 블록체인에는 숫자 체인 ID가 있습니다(예: Ethereum = `1`, Bitcoin = `-1`). 전체 목록은 [지원되는 체인](/ko-kr/api-documentation/introduction/supported-chains.md)을 참조하세요. ## 다음 단계 * [인증](/ko-kr/api-documentation/introduction/authentication.md) — API 요청 인증 방법 * [레이트 제한](/ko-kr/api-documentation/introduction/rate-limits.md) — 엔드포인트별 기본 레이트 제한 * [지원되는 체인](/ko-kr/api-documentation/introduction/supported-chains.md) — 체인 및 해당 ID * [변경 로그](/ko-kr/api-documentation/introduction/changelog.md) — 최근 API 업데이트