# 블랙리스트 월렛 주소 탐지 API (옵션)

## 가상자산 지갑주소의 블랙리스트 위험을 탐지하고 해당 결과를 반환합니다.

<mark style="color:green;">`POST`</mark> `/v1/code/bl`

가상자산 지갑주소를 전달하여, 해당 지갑주소에 대한 위험을 탐지합니다.

지갑주소에 대한 위험 탐지 결과는 '블랙/그레이/화이트/정보없음'으로 전달되며, 탐지 결과가 '블랙'과 '그레이'에 해당될 경우 범죄피해 유형 정보가 추가로 전달됩니다.

* 블랙리스트 월렛 주소 탐지 API는 코드와 웁살라시큐리티가 공동으로 운영합니다.
* 이용 문의 및 신청은 CODE 담당자(<partnership@codevasp.com>)에게 연락주시기 바랍니다.<br>

**REQUEST Body Schema: application/jsonRequest**

* walletAddress(Required): 가상 자산 지갑 주소입니다.
* chain(Optional): 가상 자산의 심볼입니다. (예: Ethereum 또는 Ether 대신 ETH)

```json
{
  "walletAddress": "0x67c9c03dC2aa8C7EcB6b30494aA757367ed2981C"
  "chain" : "ETH"
}
```

**Response**

*200 OK*

*RESPONSE SCHEMA: application/json*

* result(Required): 요청된 지갑주소에 대한 블랙리스트 탐지 결과입니다.
  * NORMAL: 정상응답.
  * ERROR: 에러응답
* reasonMsg(Optional) : ERROR 인 경우 상세 메시지를 정의합니다.
* id(Required) : 요청 시 생성된 트래픽 아이디 입니다.
* walletAddress(Required) :  요청된 가상자산 지갑주소입니다.
* securityCategory(Required) : 요청된 가상자산 지갑주소에 대한 탐지 결과(위험도)입니다.
  * BLACK : 위험
  * GRAY : 주의
  * WHITE : 일반
  * UNKNOWN : 정보없음 (위험도를 확인할 수 없는 지갑주소)
* securityTags(Optional) : 요청된 가상자산 지갑주소가 'BLACK, GRAY' 일 경우, 범죄피해 유형 정보가 전달됩니다.

#### 정상응답

```json
{
    "result": "NORMAL"
    "id": "dummy-0313013706-57359efa",
    "walletAddress": "0x67c9c03dC2aa8C7EcB6b30494aA757367ed2981",
    "securityCategory": "BLACK",
    "securityTags": [Gambling, Malware, Darknet]
}
```

#### 에러응답

```json
{
    "result": "ERROR"
    "reasonMsg" : "Connect timed out",
    "id": "dummy-0313013706-57359efa",
    "walletAddress": "0x67c9c03dC2aa8C7EcB6b30494aA757367ed2981"
}
```

\
**필수 파라미터를 입력하지 않은 경우**

422 Unprocessable Entity

*RESPONSE SCHEMA: application/json*

```json
{
    "errorType": "INVALID_MSG_FIELD_VALUE",
    "errorMsg": "[walletAddress] Please enter a value."
}
```

\
**서비스 미가입 요청 시**

422 Unprocessable Entity

*RESPONSE SCHEMA: application/json*

```json
{
    "errorType": "INVALID_ORIGIN",
    "errorMsg": "That feature is not supported."
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://codevasp.gitbook.io/code-api-docs-ko/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.