주소로 VASP 찾기 요청에 대한 결과를 조회합니다.
❗️코드를 통한 지갑 주소 조회는 VASP 소속의 '입금이 가능한 사용자 지갑'만을 검색합니다. 예를 들어 거래소 소유의 콜드 월렛 등은 검색 대상이 아닙니다.
❗️동기 방식으로 작동하는 API로 요청 후 즉시 응답을 받을 수 있습니다.
Path Parameter
| 이름 | 필수 여부 | 타입 | 설명 |
|---|---|---|---|
| requestId | 필수 | string | 주소로 VASP 찾기 요청 시 전송 한 requestId |
Response
| 이름 | 필수 여부 | 타입 |
|---|---|---|
| result | 필수 | string |
| reasonType | 옵션 | string |
| reasonMsg | 옵션 | string |
| beneficiaryVaspEntityId | 옵션 | string |
| requestId | 필수 | string |
| analysisResult | 필수 | array |
result: 요청 결과입니다.
-valid: 정상적으로 지갑 검색 결과가 반환된 경우 입니다.
-invalid: 지갑 검색 결과 값이 유효하지 않을 경우 입니다. reasonType 값으로 상세 내용을 구분할 수 있습니다.
reasonType: 응답이 invalid인 경우 사유를 설명합니다.
-NOT_FOUND_ADDRESS: 가상자산 주소를 찾을 수 없는 경우 입니다.
-LACK_OF_INFORMATION: requestId 를 찾지 못한 경우 입니다.
-PROCESSING: 검색이 완료되지 않았습니다. 잠시 후 다시 요청해 주세요. 약 10초 이상의 인터벌을 추천합니다.
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"
}