VASP 목록 조회 API

VASP 목록 조회

GET http://<enclave-endpoint>/v1/vasps

VASP (가상 자산 서비스 제공 업체)의 VASP 목록을 조회할 수 있습니다.

VASP에서 출금 시, 상대 VASP를 선택할 때 사용됩니다. 이 API를 통해 VASP 리스트를 조회한 다음, 선택한 vaspId (VASP의 ID) 필드의 값을 이용하여, 검증 요청 시 사용합니다.

기본적으로 트래블룰 프로토콜을 사용하는 회원사 중에서 자신의 VASP와 전송이 가능한 VASP만 표시됩니다.

Request Query Parameters

Field Name	Data Type	Required	Description	Default
protocol	string	false	조회하고자 하는 프로토콜 이름 (ex. VERIFYVASP or CODE or all)	all

Response Body

Response Body Examples

• 200 OK

{
  "vasps": [
    {
      "health": "UP",
      "vaspId": "27372039731940770",
      "vaspName": "A Exchange",
      "legalName": "A Exchange",
      "jurisdiction": "Singapore",
      "isAlliance": true,
      "country": "Singapore",
      "countryCode": "SG",
      "protocol": "VERIFYVASP",
      "licensedStatus": "Processing",
      "vaspStatus": "VERIFIED-MEMBER",
      "createdAt": "2021-09-27T01:48:38.000Z",
      "updatedAt": "2021-11-09T07:31:54.000Z"
    },
    {
      "health": "UP",
      "vaspId": "27372039731940165",
      "vaspName": "B Exchange",
      "legalName": "B Exchange",
      "jurisdiction": "The Republic of Korea",
      "isAlliance": true,
      "country": "The Republic of Korea",
      "countryCode": "KR",
      "protocol": "CODE",
      "licensedStatus": null,
      "vaspStatus": "INTEROPERATED",
      "createdAt": "2021-09-27T01:48:38.000Z",
      "updatedAt": "2022-01-13T15:27:50.000Z"
    }
  ]
}

Field Name	Data Type	Required	Description
vasps	object	true	VASP 정보
vasps.health	string	true	VASP Enclave 서버의 헬스 정보
vasps.vaspId	string	true	VASP 아이디
vasps.vaspName	string	true	VASP 이름 Business Name
vasps.legalName	string	false	VASP 법적 이름 Legal Name
vasps.jurisdiction	string	false	Jurisdiction of Incorporation (country or region)
vasps.isAlliance	boolean	false	VerifyVASP 회원사 여부
vasps.country	string	false	Country
vasps.countryCode	string	false	Country Code
vasps.protocol	string	true	Travel Rule Protocol
vasps.licensedStatus	string	false	Status of the VA License
vasps.vaspStatus	string	true	VerifyVASP 상의 VASP 상태. (하단 설명 참조)
vasps.createdAt	Date	true	VASP 정보 생성 시간. UTC ISO 8601 format.
vasps.updatedAt	Date	true	VASP 정보 수정 시간. UTC ISO 8601 format.

• vasps.vaspStatus 필드에는 다음과 같은 값이 들어갈 수 있습니다.

  • “VERIFIED-MEMBER”, ”VERIFIED”, ”UNVERIFIED”, "INTEROPERATED" 중 한 개의 값을 갖습니다.

  • UNVERIFIED: 아직 회원가입을 하지 않은 경우.

  • VERIFIED: 회원가입을 했지만 아직 Alliance(회원사)로 승인되지 않은 경우. 또는 Alliance이지만 아직 Enclave Server를 설치하지 않은 경우.

  • VERIFIED-MEMBER: Alliance(회원사) 이면서 Enclave 서버가 정상 실행되어 거래가 가능한 경우.

  • INTEROPERATED: 다른 Travel rule protocol의 회원사인 경우.

• vasps.protocol 필드에는 다음과 같은 값이 들어갈 수 있습니다.

  • VERIFYVASP: VerifyVASP 프로토콜 회원사

  • CODE: CODE 프로토콜 회원사