Travel Rule API 요청의 경우 Header, Body에 입력할 데이터를 암호화하여 응답으로 제공합니다. API 종류별로 해당 Travel Rule API에 대해 전달받은 값을 그대로 사용하면 편리합니다.

apiType ENUM은 다음과 같습니다.:

SEARCH_VASP_LIST : VASP 목록 조회, ID Connect VASP 목록 조회 , 코인별 네트워크

SEARCH_PUBKEY_LIST : 공개키 조회

SEARCH_ADDRESS_REQUEST : 주소로 VASP 찾기 요청

SEARCH_ADDRESS_RESULT : 주소로 VASP 찾기 결과 조회

SEARCH_ADDRESS : 가상자산 주소 조회

TRANSFER_AUTHORIZATION : 자산 이전 허가 요청

REPORT_TRANSFER_RESULT : 자산 이전 결과(txid) 전송

SEARCH_TRANSACTION_STATUS : 트랜잭션 상태 조회

FINISH_TRANSFER : 자산 이전 종료

SEARCH_TRANSACTION_ID : TXID로 VASP찾기 요청

FETCH_TRANSACTION_ID : TXID로 VASP찾기 결과 조회

VERIFICATION_TRANSACTION_ID : 자산 이전 데이터 요청

SCREENING : 스크리닝

UNHOSTED_WALLET_VERIFICATION : Unhosted Wallet Token 발급

UNHOSTED_WALLET_DATA : Unhosted Wallet 검증 정보 조회

VASP 목록 조회

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`SEARCH_VASP_LIST` 입력

{
    "allianceName": "CODE",
    "apiType": "SEARCH_VASP_LIST"
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key

{
  "signature": "siBkH9hov/7yfU8bedguB0mMIdt04DQUnB85mVPpzrMr8i+SYl3Pn46U2kvjrxEzwCSaH5E5W0nFsPyRfHbNCw==",
  "nonce": 803400752,
  "dateTime": "2023-06-21T05:25:52Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo="
}

공개키 조회

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`SEARCH_PUBKEY_LIST` 입력

{
    "allianceName": "CODE",
    "apiType": "SEARCH_PUBKEY_LIST"
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key

{
  "signature": "ouCcxqhDtsU4N9nN05QP6J6gJoJsZqilsj296C2bRNAMB1MCmVVChJ7OkhU0SVdQWaDMg3YMLZmgMr2yJfpMDQ==",
  "nonce": 1727097200,
  "dateTime": "2023-06-21T05:25:28Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo="
}

주소로 VASP 찾기 요청

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`SEARCH_ADDRESS_REQUEST` 입력
request	필수	요청 Body

{
    "allianceName": "CODE",
    "apiType": "SEARCH_ADDRESS_REQUEST",
    "request": {
        "currency": "XRP",
        "beneficiaryWalletAddress": "0x1234567890123456789012345678901234567890",
        "requestId": "fafd59e2-aff7-4cff-b7d8-9caa0cda70da"
    }
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
  "signature": "iDONJT6ck7bZD2++nGrknOR+o+aultZpwvWGRzabOePQvylN93A/9Zs6g+9mD7cnSMkE7NpuAKtKHNZvWP0RDA==",
  "nonce": 1048167312,
  "dateTime": "2023-06-21T05:25:16Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"currency\":\"XRP\",\"addressNumber\":\"rHcFoo6a9qT5NHiVn1THQRhsEGcxtYCV4d:memo or tag\",\"requestId\":\"fafd59e2-aff7-4cff-b7d8-9caa0cda70da"}"
}

주소로 VASP 찾기 결과 조회

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`SEARCH_ADDRESS_RESULT` 입력

{
    "allianceName": "CODE",
    "apiType": "SEARCH_ADDRESS_RESULT"
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key

{
  "signature": "iDONJT6ck7bZD2++nGrknOR+o+aultZpwvWGRzabOePQvylN93A/9Zs6g+9mD7cnSMkE7NpuAKtKHNZvWP0RDA==",
  "nonce": 1048167312,
  "dateTime": "2023-06-21T05:25:16Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo="
}

가상자산 주소 조회

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`SEARCH_ADDRESS` 입력
remotePublicKey	필수	수신 하는 VASP의 Public Key
request	필수	요청 Body

{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "SEARCH_ADDRESS",
    "request": {
        "currency": "USDT",
        "beneficiaryWalletAddress": "0x1234567890123456789012345678901234567890", 
        "address": "0x1234567890123456789012345678901234567890", // optional for GTR or Sygna alliances
        "network": "ETH", // optional for GTR or Sygna alliances
        "tag": "tag if needed" // optional for GTR or Sygna alliances
    }
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
  "signature": "iDONJT6ck7bZD2++nGrknOR+o+aultZpwvWGRzabOePQvylN93A/9Zs6g+9mD7cnSMkE7NpuAKtKHNZvWP0RDA==",
  "nonce": 1048167312,
  "dateTime": "2023-06-21T05:25:16Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"currency\":\"XRP\",\"payload\":\"7UGcPV9aZ+NGZNdeV31eXyuEpQKHPA0kjaFvcUt9f8BIXG7IrkqiG2sXBqF9KZC5CZBAZ4xqnlHl2+ZSjqNSw9lm08y55NQTkIPNMHjdpsWCOItg4j5G+HDy2k8pZxmRZP7nVI6OkquJ7oB0jz31GL5uIPZd76NaBzOVy9dXe/Kp/lvTqGQj+TdD+v9C7Ez0fkOY+VPvQkzzBRlb\"}"
}

자산 이전 허가 요청

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`TRANSFER_AUTHORIZATION` 입력
remotePublicKey	필수	수신 하는 VASP의 Public Key
request	필수	생성된 Body

{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "TRANSFER_AUTHORIZATION",
    "request": {
        "amount": "0.00001",
        "tradePrice": "55555",
        "transferId": "qwewq51312",
        "tradeCurrency": "KRW",
        "historicalCost": "",
        "currency": "BTC",
        "originatingVasp": {},
        "isExceedingThreshold": true,
      
        // optional for GTR,Sygna
        "address": "",
        "tag":"",
        "network":"",
      
        // originator
        "originatorNaturalPersonLastName": "Barnes",
        "originatorNaturalPersonFirstName": "Robert",
        "originatorNaturalPersonLocalLastName": "반스",
        "originatorNaturalPersonLocalFirstName": "로버트",
        "originatorLegalName": "Coinone., Ltd.",
        "originatorLegalLocalName": "(주)코인원",
        "originatorLegalAddressType": "GEOG",
        "originatorLegalTownName": "TownName",
        "originatorLegalAddressLine":  [
           "Gangnam-gu",
           "1234"
        ],
        "originatorLegalCountry": "KR",
        "originatorLegalNationalIdentifier": "1234567890",
        "originatorLegalNationalIdentifierType": "RAID",
        "originatorLegalRegistrationAuthority":  "RA000657",
        "originatorLegalCountryOfRegistration": "KR",
        "originatorLegalPersonList" : [
          {
            "firstName": "Minsu",
            "lastName": "Kim",
            "localFirstName":"민수",
            "localLastName":"김"
          },
          {
            "firstName": "Soonhee",
            "lastName": "Lee",
            "localFirstName":"순희",
            "localLastName":"이"}
        ],
        "nameIdentifierType": "LEGL",
        "customerIdentification": "3213213qweqwe213312",
        "originatorWalletAddress": "012345678900",
        "originatorNaturalPersonDob": "1990-01-01", 
        "originatorNaturalPersonPob": "Seoul", 
      
        // originatingVasp
        "originatingVaspCountryOfRegistration": "KR",
        "originatingVaspLegalName": "Korbit Inc.",
        "originatingVaspNameIdentifierType" : "LEGL",
        "originatingVaspAddressType": "GEOG",
        "originatingVaspTownName": "Seoul",
        "originatingVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "originatingVaspCountry": "KR",
        "originatingVaspNationalIdentifier": "1234567890",
        "originatingVaspNationalIdentifierType": "RAID",
        "originatingVaspRegistrationAuthority": "RA000657",
        // beneficiary
        "beneficiaryWalletAddress": "012345678901",
        "beneficiaryNameIdentifierType": "LEGL",
        "beneficiaryCustomerIdentification": "3213213qweqwe213312",
        "beneficiaryNaturalPersonLastName": "스미스",
        "beneficiaryNaturalPersonFirstName": "앨리스",
        "beneficiaryNaturalPersonLocalLastName": "Smith",
        "beneficiaryNaturalPersonLocalFirstName": "Alice",,
        "beneficiaryNaturalPersonDob": "1990-01-01", 
        "beneficiaryNaturalPersonPob": "New York", 
        
        "beneficiaryLegalName": "Coinone., Ltd.",
        "beneficiaryLegalLocalName": "(주)코인원",
        "beneficiaryLegalPersonList" : [
          {
            "firstName": "Minsu",
            "lastName": "Kim",
            "localFirstName":"민수",
            "localLastName":"김"
          },
          {
            "firstName": "Soonhee",
            "lastName": "Lee",
            "localFirstName":"순희",
            "localLastName":"이"}
        ]
    }
}

{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "TRANSFER_AUTHORIZATION",
    "request": {
        "amount": "0.00001",
        "tradePrice": "55555",
        "transferId": "qwewq51312",
        "tradeCurrency": "KRW",
        "historicalCost": "",
        "currency": "BTC",
        "originatingVasp": {},
        "isExceedingThreshold": true,
      
        // originator
        "originatorNaturalPersonLastName": "Barnes",
        "originatorNaturalPersonFirstName": "Robert",
        "originatorNaturalPersonLocalLastName": "반스",
        "originatorNaturalPersonLocalFirstName": "로버트",
        "originatorNaturalPersonDob": "1990-01-01", 
        "originatorNaturalPersonPob": "Seoul", 
      
        "originatorLegalLocalName": "(주)코인원",
        "originatorLegalName": "Coinone., Ltd.",
        "originatorLegalPersonList" : [
          {
            "firstName": "Minsu",
            "lastName": "Kim",
            "localFirstName":"민수",
            "localLastName":"김"
          },
          {
            "firstName": "Soonhee",
            "lastName": "Lee",
            "localFirstName":"순희",
            "localLastName":"이"}
        ],
        "nameIdentifierType": "LEGL",
        "customerIdentification": "originatorCustomerIdentification",
        "originatorWalletAddress": "012345678900",
        // originatingVasp
        "originatingVaspCountryOfRegistration": "KR",
        "originatingVaspLegalName": "Korbit Inc.",
        "originatingVaspNameIdentifierType": "LEGL",
        "originatingVaspAddressType": "GEOG",
        "originatingVaspTownName": "Seoul",
        "originatingVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "originatingVaspCountry": "KR",
        "originatingVaspNationalIdentifier": "1234567890",
        "originatingVaspNationalIdentifierType": "RAID",
        "originatingVaspRegistrationAuthority": "RA000657",
        // beneficiary
        "beneficiaryWalletAddress": "012345678901",
        "beneficiaryNameIdentifierType": "LEGL",
        "beneficiaryCustomerIdentification": "3213213qweqwe213312",
        "beneficiaryNaturalPersonLastName": "스미스",
        "beneficiaryNaturalPersonFirstName": "앨리스",
        "beneficiaryNaturalPersonLocalLastName": "Smith",
        "beneficiaryNaturalPersonLocalFirstName": "Alice",
        "beneficiaryNaturalPersonDob": "1990-01-01", 
        "beneficiaryNaturalPersonPob": "New York", 
      
        "beneficiaryLegalLocalName": "(주)코인원",
        "beneficiaryLegalName": "Coinone., Ltd.",
        "beneficiaryLegalPersonList" : [
          {
            "firstName": "Minsu",
            "lastName": "Kim",
            "localFirstName":"민수",
            "localLastName":"김"
          },
          {
            "firstName": "Soonhee",
            "lastName": "Lee",
            "localFirstName":"순희",
            "localLastName":"이"}
        ],
        // beneficiaryVasp
        "beneficiaryVaspCountryOfRegistration": "KR",
        "beneficiaryVaspLegalName": "Korbit Inc. beneficiaryVaspLegalName",
        "beneficiaryVaspNameIdentifierType": "LEGL",
        "beneficiaryVaspAddressType": "GEOG",
        "beneficiaryVaspTownName": "Seoul",
        "beneficiaryVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "beneficiaryVaspCountry": "KR",
        "beneficiaryVaspNationalIdentifier": "1234567890",
        "beneficiaryVaspNationalIdentifierType": "RAID",
        "beneficiaryVaspRegistrationAuthority": "RA000657"
    }
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
  "signature": "pOCyDvkDsPGq5oU4Of7C2IwFv09Oovbp0tKU2mFoxtXuPPWsTJ/UOUGkebvskTx4PV1z9VFNazmDPcI9A6EFDA==",
  "nonce": 1131014480,
  "dateTime": "2023-06-21T05:25:07Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"transferId\":\"qwewq51312\",\"currency\":\"BTC\",\"amount\":\"0.00001\",\"historicalCost\":\"\",\"tradePrice\":\"55555\",\"tradeCurrency\":\"KRW\",\"isExceedingThreshold\":true,\"originatingVasp\":{},\"payload\":\"6Mxwnomavmz61KaqpcNVTNNKBOiz1zDSeIl6MXwRKehqf24+xpQyd2Jlxz/oQM6U7cCa8FXcLwL3F3u5rDVYA6P9fIK9NWGyFMg5mmKrWjX0nHtUQh9YmKwugRkImOyzY1BIWIDbN2rViVwIyDwScz/G15eZXTR6scZIz+3IlitRNm6xSpjRHwIgKHgrOaYCByBp/igwfw/ejFr9OQkSJZLfCwHCn+YA/mH9syDmONXtLpkK21sE2BMrbCEsXn7NuJFcOGMzjG9itS/FtkM3ppbfntnsrcVg91oaKGoUNkWtsHCVe+yBhUT10yRwXJDb2K1QXVfmirPqZeRfx7o0IjIONi5pqbAqJoKnKqsvypqvnQ3nn+nO9ZuU+DnWWxbJH+H9qp/zpo0WPXzY3utUDEmiVJwKmZHwL45jz48Z4yTcCMdi7FfFCxxnj3dvrCQ4ux9Wqnqu4SpWoEX2NZ4wp9oXh6le9fBX6w4sqw9nMJtEkEOAvj111/6w0I/SDh55BvDNvnyxWW7pCBDrR2egIFFH+NWjl8vMZWJxkpQLfx/TDqLrAxHbOuIV2xFKiwrUFjNx8G6YCeO0hd02vSaZ6AUi9ZFJDUIAcYdTEbBhTDqDdMKiZvXxDTAOjL2mOdk3alOug4Sput5BJs7TYZh9RL0IF/2cR23Cjo6X5CRYC8mAYGb1uPbmEE1LU/pneWDT+aWKAIAo+zlaPksVM+emuYywm84h4rQnDbMHTqSoalbdm5gsbYmjpj121b9JhprBMzZu8NSljUXzhaNI12jEO/ZEPrHfmul2/I1cOn8ldIZswcTCk0heY7D0ytVOkMScWCVPdT4Qhx5z3DUiPVe7swnvcUzRIHAWsyymjtNJ5oiH0muOsItivmuXh96d6ydCVboHIuTF/qS/s8NPWWQGTOavbgDq3k0mRLfO3wXjsbLVH4WnUFPlUaukHPgJurkImJDWaT1+Hu0yp/mK8c+8ZS2XzzSW2vDp+QtvIuRB+q/uih/Vl1IqV7dW4DSW5kyyw3KwrTB5TObufkFR46uKluxqobCeNbmA5ojuUpe+1GUypzZXKplrqVLZRApa/AwmWasVp6RiEXMIm/UMuXSOjb2Q3dR5LX5SxluY18lts2J8EDB7CT/DhGULws+KK3w+iSwVzpVmBQbz3b7KneOIsS2uAwsTPZZl1CW7wnMXCyYwjN9Yzr7juHQ56YgZX/YltAOyMMRfyCJrTApU9ppb++bB4PTjJIsFfW7wBLGJ4As/JrQDnlw51AJEP5bXs7PKYE+QOt4161kv6iaL9U226jIQWgOYD9qXL0H0ek1e4GapX8ttWadgXnp7stYrgSgeiMIIw5EgH3VOu2/hTjhJuRFi3rwbT9bFRAQXSsxD/FviZ07YIzyn4q9hFMBe7SfPQFo54XJLEW3Ze4fbHY/ewL+WUHw9KImYocZejAhV1eP1DdA9oJVHbBrXW9cafIJKRNKYaOSC5j6bUoJAC6v593GBALfp3ehs2q5SZI31gsJSzjhCwmoKHgowoH8ooovQHcIm6wz4icpANHYm40us7Z4caDPjF+JQO8PZcCwmmVKm5vXLQNrAoaHkLMKjWXOKBL/UEgpqam2GZTqAs3kDIpZPSna/5W6wXdPEt0kikiaZvuaR4XZPDGO/JS7Gz7qNECZu0EStRXOQqRe2OHATLMKWJMxfh9XaDNoQLutcQzT5pNiugdGjdi1zRULNSQ==\"}"
}

자산 이전 결과(txid) 전송

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`REPORT_TRANSFER_RESULT` 입력
request	필수	요청 Body

{
    "allianceName": "CODE",
    "apiType": "REPORT_TRANSFER_RESULT",
    "request": {
        "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002",
        "txid": "311BFF73D9B7969CCF1042186180159C724FAB59013A7A034A93E5FB9D6BAFE6",
        "beneficiaryAddress": "address:tag"
    }
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
  "signature": "iDONJT6ck7bZD2++nGrknOR+o+aultZpwvWGRzabOePQvylN93A/9Zs6g+9mD7cnSMkE7NpuAKtKHNZvWP0RDA==",
  "nonce": 1048167312,
  "dateTime": "2023-06-21T05:25:16Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"currency\":\"XRP\",\"payload\":\"7UGcPV9aZ+NGZNdeV31eXyuEpQKHPA0kjaFvcUt9f8BIXG7IrkqiG2sXBqF9KZC5CZBAZ4xqnlHl2+ZSjqNSw9lm08y55NQTkIPNMHjdpsWCOItg4j5G+HDy2k8pZxmRZP7nVI6OkquJ7oB0jz31GL5uIPZd76NaBzOVy9dXe/Kp/lvTqGQj+TdD+v9C7Ez0fkOY+VPvQkzzBRlb\"}"
}

트랜잭션 상태 조회

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`SEARCH_TRANSACTION_STATUS`입력
request	필수	요청 Body

{
    "allianceName": "CODE",
    "apiType": "SEARCH_TRANSACTION_STATUS",
    "request": {
        "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002"
    }
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
  "signature": "5SvoIHj5+sY6vXGVs2RBzVriTvYjhyPMJhzSq4/hJdpv6nC4WCswj7j31arl6BoTuhCa7eaudtyp2JpVVoLGDA==",
  "nonce": 1459904464,
  "dateTime": "2023-06-21T05:24:40Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"transferId\":\"b09c8d00-8da9-11ec-b909-0242ac120002\"}"
}

자산 이전 종료

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`FINISH_TRANSFER` 입력
request	필수	요청 Body

{
    "allianceName": "CODE",
    "apiType": "FINISH_TRANSFER",
    "request": {
        "transferId": "b09c8d00-8da9-11ec-b909-0242ac120002",
        "status": "canceled",
        "reasonType": "SANCTION_LIST"
    }
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
  "signature": "3zfR+ONXteTcs3o7MMT69QyCYbBpXJFhXXqRAo99UxrpAOTQUEpUVffTZ2wRKPSkfxdqEvoNHJlA2PShZBVgBA==",
  "nonce": 1593438672,
  "dateTime": "2023-06-21T05:24:09Z",
  "publicKey": "LOpv3Vd7PKLrlDmk/MFi6mc2rPWhi3G0H3D74dayxSo=",
  "body": "{\"transferId\":\"b09c8d00-8da9-11ec-b909-0242ac120002\",\"status\":\"canceled\",\"reasonType\":\"SANCTION_LIST\"}"
}

TXID로 VASP 찾기 요청

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`SEARCH_TRANSACTION_ID` 입력
request	필수	요청 Body

{
    "allianceName": "CODE",
    "apiType": "SEARCH_TRANSACTION_ID",
    "request": {
        "txid": "0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674",
        "beneficiaryAddress": "address:tag",
        "requestId" : "fafd59e2-aff7-4cff-b7d8-9caa0cda70da"
    }
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
    "signature": "JY+mP1kj2zIQAzxUiQtwRrFmt0Rs+DRxYXHdCkpImC3qiPWEqploS8zM6s8r1AX8iiy+gBrcOaC3EdooR+VgBQ==",
    "nonce": 1324920960,
    "dateTime": "2024-05-23T05:16:18Z",
    "publicKey": "sG65Uno5V+Vm6XOXuwSuM5XMn+HgpqOZi+8PGaTIAMM=",
    "body": "{\"txid\":\"0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674\",\"beneficiaryAddress\": \"address:tag\",\"requestId\":\"fafd59e2-aff7-4cff-b7d8-9caa0cda70da\"}"
}

TXID로 VASP 찾기 결과 조회

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`FETCH_TRANSACTION_ID` 입력

{
    "allianceName": "CODE",
    "apiType": "FETCH_TRANSACTION_ID"
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key

{
    "signature": "GNAy7n2KrjRiV1Cgbi/ifVbQipchsqFGS5DULqxeYZDgiV+uy3IDpbD5PrwFyUJkDUeq+3O5VbY8m6uAjIfpDA==",
    "nonce": 501286944,
    "dateTime": "2024-05-23T05:16:49Z",
    "publicKey": "sG65Uno5V+Vm6XOXuwSuM5XMn+HgpqOZi+8PGaTIAMM="
}

자산 이전 데이터 요청

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`VERIFICATION_TRANSACTION_ID` 입력
remotePublicKey	필수	수신 하는 VASP의 Public Key
request	필수	생성된 Body

{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "VERIFICATION_TRANSACTION_ID",
    "request": {
        "txid":"0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674",
        "beneficiaryAddress": "address:tag",
        "transferId" : "fafd59e2-aff7-4cff-b7d8-9caa0cda70da",
        
        // beneficiary
        "beneficiaryWalletAddress": "012345678901",
        "beneficiaryNameIdentifierType": "LEGL",
        "beneficiaryCustomerIdentification": "3213213qweqwe213312",
        "beneficiaryNaturalPersonLastName": "스미스",
        "beneficiaryNaturalPersonFirstName": "앨리스",
        "beneficiaryNaturalPersonLocalLastName": "Smith",
        "beneficiaryNaturalPersonLocalFirstName": "Alice",
        "beneficiaryLegalName": "Coinone., Ltd.",
        "beneficiaryLegalLocalName": "(주)코인원",
        "beneficiaryLegalPersonList" : [
          {
            "firstName": "Minsu",
            "lastName": "Kim",
            "localFirstName":"민수",
            "localLastName":"김"
          },
          {
            "firstName": "Soonhee",
            "lastName": "Lee",
            "localFirstName":"순희",
            "localLastName":"이"}
        ],
        // beneficiaryVasp
        "beneficiaryVaspCountryOfRegistration": "KR",
        "beneficiaryVaspLegalName": "Korbit Inc. beneficiaryVaspLegalName",
        "beneficiaryVaspNameIdentifierType": "LEGL",
        "beneficiaryVaspAddressType": "GEOG",
        "beneficiaryVaspTownName": "Seoul",
        "beneficiaryVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "beneficiaryVaspCountry": "KR",
        "beneficiaryVaspNationalIdentifier": "1234567890",
        "beneficiaryVaspNationalIdentifierType": "RAID",
        "beneficiaryVaspRegistrationAuthority": "RA000657"
    }
}

{
    "allianceName": "CODE",
    "remotePublicKey": "8DJomhrvr0zD11+m3nwG3ZeO9OsSY8uLHdA7WgoaX0g=",
    "apiType": "VERIFICATION_TRANSACTION_ID",
    "request": {
        "txid":"0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674",
        "vout": "0",
        "transferId" : "fafd59e2-aff7-4cff-b7d8-9caa0cda70da",
 
        "amount": "0.00001",
        "tradePrice": "55555",
        "tradeCurrency": "KRW",
        "historicalCost": "",
        "currency": "BTC",
        "originatingVasp": {},
        "isExceedingThreshold": true,

        // originator
        "originatorNaturalPersonLastName": "Barnes",
        "originatorNaturalPersonFirstName": "Robert",
        "originatorNaturalPersonLocalLastName": "반스",
        "originatorNaturalPersonLocalFirstName": "로버트",
        "originatorLegalName": "Coinone., Ltd.",
        "originatorLegalLocalName": "(주)코인원",
        "originatorLegalPersonList" : [
          {
            "firstName": "Minsu",
            "lastName": "Kim",
            "localFirstName":"민수",
            "localLastName":"김"
          },
          {
            "firstName": "Soonhee",
            "lastName": "Lee",
            "localFirstName":"순희",
            "localLastName":"이"}
        ],
        "nameIdentifierType": "LEGL",
        "customerIdentification": "originatorCustomerIdentification",
        "originatorWalletAddress": "012345678900",
        // originatingVasp
        "originatingVaspCountryOfRegistration": "KR",
        "originatingVaspLegalName": "Korbit Inc.",
        "originatingVaspNameIdentifierType": "LEGL",
        "originatingVaspAddressType": "GEOG",
        "originatingVaspTownName": "Seoul",
        "originatingVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "originatingVaspCountry": "KR",
        "originatingVaspNationalIdentifier": "1234567890",
        "originatingVaspNationalIdentifierType": "RAID",
        "originatingVaspRegistrationAuthority": "RA000657",

        // beneficiary
        "beneficiaryWalletAddress": "012345678901",
        "beneficiaryNameIdentifierType": "LEGL",
        "beneficiaryCustomerIdentification": "3213213qweqwe213312",
        "beneficiaryNaturalPersonLastName": "스미스",
        "beneficiaryNaturalPersonFirstName": "앨리스",
        "beneficiaryNaturalPersonLocalLastName": "Smith",
        "beneficiaryNaturalPersonLocalFirstName": "Alice",
        "beneficiaryLegalName": "(주)코인원",
        "beneficiaryLegalPersonList" : [
          {
            "firstName": "Minsu",
            "lastName": "Kim",
            "localFirstName":"민수",
            "localLastName":"김"
          },
          {
            "firstName": "Soonhee",
            "lastName": "Lee",
            "localFirstName":"순희",
            "localLastName":"이"}
        ],
        // beneficiaryVasp
        "beneficiaryVaspCountryOfRegistration": "KR",
        "beneficiaryVaspLegalName": "Korbit Inc. beneficiaryVaspLegalName",
        "beneficiaryVaspNameIdentifierType": "LEGL" ,
        "beneficiaryVaspAddressType": "GEOG",
        "beneficiaryVaspTownName": "Seoul",
        "beneficiaryVaspAddressLine": [
            "14 Teheran-ro 4-gil, Gangnam-gu",
            "4th floor"
        ],
        "beneficiaryVaspCountry": "KR",
        "beneficiaryVaspNationalIdentifier": "1234567890",
        "beneficiaryVaspNationalIdentifierType": "RAID",
        "beneficiaryVaspRegistrationAuthority": "RA000657"
    }
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
    "signature": "6kfex70cuBgi6yYqRIFmDubuQavgARLjOv2aCmVWBAJ7ENAxumzKtoVNZ/MvoOcYkfkEJd1VTdfDSsG1LFZDCg==",
    "nonce": 1513115728,
    "dateTime": "2024-05-23T05:20:19Z",
    "publicKey": "sG65Uno5V+Vm6XOXuwSuM5XMn+HgpqOZi+8PGaTIAMM=",
    "body": "{\"transferId\":\"fafd59e2-aff7-4cff-b7d8-9caa0cda70da\",\"txid\":\"0xac52211cafdbfe2b59571eed29bd22608984df5e11d771bb620a2213a333a674\",\"beneficiaryAddress\":\"address:tag\",\"currency\":null,\"amount\":null,\"historicalCost\":null,\"tradePrice\":null,\"tradeCurrency\":null,\"isExceedingThreshold\":false,\"payload\":\"eds32d3TXBkjqokWwrXLuDesLqC8Fxu7G9WoSb2UbnEQ40xzA1K98ue60I5r64voAc8IizoEEVLhhEIt4YB7bci6nW0tb6MU87Zl6b7TXRNUP3Sz6CBWzu5BcrAZ+qswgwmfgCXu3JiZVWyeMq91evmM4jxoNTA//hM4GTEiioiPkSlTSHPmxKTRaVk/ilXqIxsJG0sK3odxu6ylZz9n/xPeS8zRz0QXQXochnywDAC8YwLI0f0MFXkrh/BUvxcTlF9wfETvzSOvRLiGXnGYpzBTXIs/WN+3YzgZ0+JryZLakQo+K0wWIZrm005dBJttLNdxHfWLItAk3f5d6kADe3as3pN2a8rnoRt2gJl4rb5YzRR2tZgHEL9MFJuOWzhCmoprw6ROiRfRk1lnxRyAv8BLPH7PWYpxxB9QXCXCXlTyzBTRpL3QqF7K1oxDshC++7DWHkimTKi3XQNrA8MUG2+b0Ti7aseav58oqtOKmcaRwP8e+VhmIDO3wxF5MzmmpwA1g8Uytpf2MU2W2xm89VODKgktmB9E/5ggTg8Y3lsNBkZKUkwC9ebnMRqGYiA/TKyrr2f2wdf/ezcAa2vJlBsFshd7sGrf/3Zx0vfk8dBUPYpKgfjwXmbRKF6zPrZjgHsLneuJo0QhumdJHX8C4FTyu5S4WjQi12YQaCMoiRgejvs9nJ/zSyGITdpA6YItTYNPa4/1GToaBpcO2O8W+EH7dV16KYonfhxwD+9zrz1WPbyDpsUjvpY1E5+Rt5rtipgNlyTGq1zf5ebzrk67W1d6OmrmjegKnBuVBVKnhcqWhO/zq8Ax5eh2QdOtvL/mWMRm6i41FBtsJAyAeGYMlub5zKVCwZaTDT4sWcfs7RLB2UzSSOfbLZfHLSgW9aVv+DP9mtdQLyyFT1MS/bPC1SUU9fwwLDq0gGM5SdSaKyoYc9gwYnQGTCJPCE84sAqtSM7oTybDtcURRsiumm4UMcFQDQ0aNrZ8FAl7UA87XxvylJAw2TXn6fNclL2pX2HASFHVPjR38lYjz+2TiYNjZH7B/Zz0s0pxZ2ukqWddML9fWs4AajDTNg7IweM7PAWIrS1MUeWc6yPiISm6yt8wIsgMKIasIM4DDT1wH+TdAARKaPCFEezpwCoUmpFWCi4Nb63+hoo0EDZ88xvboxnOZyiYK7GKGsXDMXSdRYLt+rNr8ProZs1Twz0vLqFwbiTmpntIdlSn3UNRpT79zBGRCzagFI2u3mq1n4GodO4DsfIU2ZjAGIB3s6FAiMWsxtJnTNKh26uFDmN9sXT7Kw1iFcZW3P9BhH06JtYHsmEvuwPMsZJKyAx8GueWCTXLa1hervWw+14ojazHgUQ=\"}"
}

스크리닝

Request

이름	필수 여부	설명
allianceName	필수	Travel Rule 프로토콜의 코드로, 기본값으로 'CODE' 입력 가능
apiType	필수	`SCREENING` 입력
request	필수	생성된 Body

{
    "allianceName": "CODE", 
    "apiType": "SCREENING",
    "request": {
        "walletAddress": "** WALLET ADDRESS **",
        "chain": "** CHAIN TYPE **"
    }
}

{
    "allianceName": "CODE", 
    "apiType": "SCREENING",
    "request": {
        "txid": "** TXID **",
        "chain": "** CHAIN TYPE **"
    }
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
    "signature": "rjhM+wJ2kzanjpTi7BAM5Lv7TsbYe+Qs+eTirbulbUNNvKWMPj76Lhpdutq8AP/wKItMKgT4jHh94x/S3YeLBA==",
    "nonce": 1694362784,
    "dateTime": "2025-08-12T07:33:25Z",
    "publicKey": "ILIszcJToqIA7DxHWMHLd5bhUx0QUV7m3KzWRX5sJ34=",
    "body": "{\"walletAddress\":\"sampleWallet\",\"chain\":\"ETH\"}"
}

Unhosted Wallet Token 발급

Request

이름	필수 여부	설명
allianceName	필수	'CODE' 만 입력 가능
apiType	필수	`UNHOSTED_WALLET_VERIFICATION` 입력
request	필수	아래 샘플 request 참고

{
    "allianceName": "CODE",
    "apiType": "UNHOSTED_WALLET_VERIFICATION",
    "request": {
      "blockchain": "BLOCKCHAIN",
      "asset": "ASSET",
      "address": "ADDRESS",
      "customerIdentification": "CUSTOMERIDENTIFICATION",
      "widgetRenderingOrigin": "widgetRenderingOrigin",
      "callbackUrl": "(Optional)CALBACKURL"
    }
    }

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key
body	필수	생성된 payload

{
    "signature": "JPtkm4oFhPEUz7yMXqDvNI1E0/PjXxgnQvflFhdV42otuppMPlUbneuWV4qcMr3Ib/uoATTIqJOUrl2oDqT/Bw==",
    "nonce": 53726960,
    "dateTime": "2026-01-29T06:29:08Z",
    "publicKey": "ILIszcJToqIA7DxHWMHLd5bhUx0QUV7m3KzWRX5sJ34=",
    "body": "{\"blockchain\":\"BLOCKCHAIN\",\"asset\":\"ASSET\",\"address\":\"ADDRESS\",\"customerIdentification\":\"CUSTOMERIDENTIFICATION\",\"widgetRenderingOrigin\":\"WIDGETRENDERINGORIGIN\",\"callbackUrl\":\"(Optional)CALLBACKURL\"}"
}

Unhosted Wallet 검증 정보 조회

Request

이름	필수 여부	설명
allianceName	필수	'CODE' 만 입력 가능
apiType	필수	`UNHOSTED_WALLET_DATA` 입력

{
    "allianceName": "CODE",
    "apiType": "UNHOSTED_WALLET_DATA"
}

Response

이름	필수 여부	설명
signature	필수	생성된 Signature
nonce	필수	생성된 Nonce
dateTime	필수	요청의 datetime
publicKey	필수	요청 하는 VASP의 Public Key

{
    "signature": "JPtkm4oFhPEUz7yMXqDvNI1E0/PjXxgnQvflFhdV42otuppMPlUbneuWV4qcMr3Ib/uoATTIqJOUrl2oDqT/Bw==",
    "nonce": 53726960,
    "dateTime": "2026-01-29T06:29:08Z",
    "publicKey": "ILIszcJToqIA7DxHWMHLd5bhUx0QUV7m3KzWRX5sJ34=",
}

Example

200200

400400