가상자산을 전송하려는 VASP는 전체 과정의 첫 단계에서 이 API를 사용하여 수취인(Beneficiary)의 가상자산의 주소(address + tag(optional))가 어느 VASP의 소유인지 알아낼 수 있습니다. 이를 통해 UI 상에서 사용자가 거래소를 선택하는 프로세스를 제거할 수 있으며, 보다 간결한 흐름을 설계할 수 있습니다.

CODE 회원사 외에는 검색이 불가능하며, NOT_FOUND_ADDRESS 결과의 경우 CODE 회원사가 아닌 경우 이거나 혹은 일시적으로 회원사의 서버 문제로 주소가 검색되지 않았을 것으로 추측할 수 있습니다.

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

❗️비동기 방식으로 작동하는 API로 요청 후 Callback URL을 사용해 결과를 수신하거나 '주소로 VASP 찾기 결과 조회' API를 통해 결과를 확인할 수 있습니다. 두 가지 방법의 결과 데이터는 동일합니다.

Request

이름	필수 여부	설명
currency	필수	이전하려는 가상자산의 심볼로, 대소문자를 구분하지 않음
addressNumber	필수	자산을 수신하는 가상자산 주소로 tag 나 memo 같은 2차 주소는 ':' 구분자로 병합
requestId	필수	결과 조회를 하기 위한 고유한 요청 ID
callbackUrl	옵션	검색 결과 Callback URL은 https:// 형식으로 작성, 해당 URL에 CODE의 IP 접근 허용 필요

{
    "currency": "xrp",
    "addressNumber": "rHcFoo6a9qT5NHiVn1THQRhsEGcxtYCV4d:memo or tag",
    "requestId": "fafd59e2-aff7-4cff-b7d8-9caa0cda70da",
    "callbackUrl": "https://endpoint.com"
}

Response

이름	필수 여부	설명
result	필수	요청 결과
requestId	필수	결과 조회를 하기 위한 고유한 요청 ID

result: 가상자산 주소 검증 결과입니다.

-SUCCESS: 정상적인 주소일 때 반환됩니다.

주소로 VASP 찾기 요청

Request

Response

Example