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

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

POST /v1/code/bl

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

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

• 블랙리스트 월렛 주소 탐지 API는 코드와 웁살라시큐리티가 공동으로 운영합니다.

• 이용 문의 및 신청은 CODE 담당자([e-mail])에게 연락주시기 바랍니다.

REQUEST Body Schema: application/jsonRequest

• walletAddress(Required): 가상 자산 지갑 주소입니다.

• chain(Optional): 가상 자산의 심볼입니다. (예: Ethereum 또는 Ether 대신 ETH)

{
  "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' 일 경우, 범죄피해 유형 정보가 전달됩니다.

정상응답

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

에러응답

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

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

422 Unprocessable Entity

RESPONSE SCHEMA: application/json

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

서비스 미가입 요청 시

422 Unprocessable Entity

RESPONSE SCHEMA: application/json

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