주소로 VASP 찾기 요청

수취인의 지갑 주소가 어느 거래소 소속인지 검색합니다.

POST /v2/code/VerifyAddress

가상 자산을 전송하려는 VASP는 전체 과정의 첫 단계에서 이 API를 사용하여 수취인(Beneficiary)의 가상 자산의 주소(address + tag(optional))가 어느 VASP의 소유인지 알아낼 수 있습니다.

이를 통해 UI 상에서 사용자가 거래소를 선택하는 프로세스를 제거할 수 있으며, 보다 간결한 흐름을 설계할 수 있습니다. 혹은 사용자가 상대 VASP 정보를 모르는 경우에도 유용할 수 있습니다.

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

비동기 방식의 API로 검색 요청을 보낸 후 약 1분 후 결과 조회를 하여 검색 결과를 알 수 있습니다. 1분마다 1개의 주소에 대해 요청을 하실 수 있으며 요청 후 1분간 추가 요청이 불가합니다.

REQUEST Body Schema: application/jsonRequest

이름	필수 여부	설명
currency	필수	이전하려는 가상 자산의 심볼입니다. (대소문자를 구분하지 않습니다)
addressNumber	필수	자산을 수신하는 가상 자산 주소입니다. tag 나 memo 같은 2차 주소는 ':' 구분자 뒤에 붙입니다.
requestId	필수	결과 조회를 하기 위한 요청ID 입니다. 유니크해야합니다.

{
  currency: "XRP",
  addressNumber : "rHcFoo6a9qT5NHiVn1THQRhsEGcxtYCV4d:memo or tag",
  requestId : "fafd59e2-aff7-4cff-b7d8-9caa0cda70da"
}

---

Response

200 OK - RESPONSE SCHEMA: application/json

• result(Required): 요청 결과입니다.

  • SUCCESS: 정상적인 요청일 때 반환됩니다

{
  "result": "SUCCESS",
  "requestId" : "fafd59e2-aff7-4cff-b7d8-9caa0cda70da"
}

429 Too Many Requests - RESPONSE SCHEMA: application/json

• 제한 시간 이내 요청의 경우

{
  "errorType": "TOO_MANY_REQUESTS",
  "errorMsg": "The request has exceeded the limit (60) per minute, source IP."
}