❗️코드를 통한 지갑 주소 조회는 VASP 소속의 '입금이 가능한 사용자 지갑'만을 검색합니다. 예를 들어 거래소 소유의 콜드 월렛 등은 검색 대상이 아닙니다.

❗️
동기 방식으로 작동하는 API로 요청 후 즉시 응답을 받을 수 있습니다.

Path Parameter

이름	필수 여부	타입	설명
requestId	필수	string	주소로 VASP 찾기 요청 시 전송 한 requestId

Response

result: 요청 결과입니다.

-valid: 정상적으로 지갑 검색 결과가 반환된 경우 입니다.

-invalid: 지갑 검색 결과 값이 유효하지 않을 경우 입니다. reasonType 값으로 상세 내용을 구분할 수 있습니다.

reasonType: 응답이 invalid인 경우 사유를 설명합니다.

-NOT_FOUND_ADDRESS: 가상자산 주소를 찾을 수 없는 경우 입니다.

-LACK_OF_INFORMATION: requestId 를 찾지 못한 경우 입니다.

-PROCESSING: 검색이 완료되지 않았습니다. 잠시 후 다시 요청해 주세요. 약 10초 이상의 인터벌을 추천합니다.

-ALLIANCE_DATA_NON_UNIQUE_RESULT: 2개 이상의 VASP로부터 'valid' 응답을 받았습니다.

reasonMsg: invalid 인 경우 상세 메시지를 정의합니다.

beneficiaryVaspEntityId: 검색된 결과 VASP의 entityId입니다.

requestId: 요청시 사용한 requestId입니다.

analysisResult: 검색 결과의 상세 내역입니다. 아래와 같은 형태의 객체의 array로 응답이 옵니다.

entityId: 검색한 VASP의 entityId입니다.
result: 검색 결과입니다. 3가지의 결과가 있을 수 있습니다. NOT_FOUND_ADDRESS, FOUND, SYSTEM_NOT_AVAILABLE.
SYSTEM_NOT_AVAILABLE은 해당 VASP의 시스템이 정상작동되지 않아 결과를 받을 수 없는 경우입니다. 만약 이 경우가 있으면서 invalid - NOT_FOUND_ADDRESS결과인 경우 확실한 결과가 아닐 수 있습니다.

{
    "entityId": "bithumb",
    "result": "NOT_FOUND_ADDRESS"
}