The Wallet Address Book allows virtual asset service providers (VASPs) to upload wallet addresses belonging to their users via the API, ensuring complete, secure, and timely data exchanges under Travel Rule requirements.

Why is it beneficial to upload your user addresses to Sumsub?

Sumsub has developed the Wallet Address Book API to ensure 100% delivery of inbound Travel Rule data exchanges.

Using the Wallet Address Book streamlines Travel Rule transactions processing and cuts operational costs as it does not require the involvement of the 3rd-party Blockchain Analytics providers (Crystal Intelligence, Merkle Science, etc.) to attribute the wallet address to a Counterparty VASP.

For security reasons, you may choose to hash your addresses.

Use Wallet Address Book

The Wallet Address Book is free and enabled on your VASP account upon creation. To ensure it is fully functional, you need to carry out the steps below.

Step 1. Import wallet addresses

You can submit up to 10.000 wallet addresses via one API call. All the data you share is encrypted/hashed in transit and/or at rest. We recommend that you implement logic that submits wallet addresses every couple of hours.

When submitting the wallet data, you can send:

• Only walletAddress, if you are ready to share the wallet addresses with Sumsub.
• Only walletAddressHash, if you do not want to share direct wallet addresses for security reasons.
• Both walletAddressHash and walletAddress, so you can check if your hashing function is the same as in Sumsub (in case the functions differ, the response returns an error).

Optionally, alongside the wallet address, you can submit identifiable user information, such as the applicant ID or unique identifier.

Use this API method as the following example demonstrates to import the wallet addresses of your users for further transaction processing.

curl -X POST \
     `https://api.sumsub.com/resources/kyt/walletAddress/import` \
     -H 'content-type: application/json' \
     -d '
        [
          {
              "walletAddress": "1njrRcKQtfjjLuQ",
              "asset": "USDT",
              "chain": "ETH"
            },
            {
              "walletAddressHash": "04c4926a21184665ef890493cd3c67a919f868724fc44adb933b911234567890",
              "asset": "USDT",
              "chain": "ETH"
            }
        ]
      '

You cannot submit customers’ PIIs.

Step 2. Have your inbound transactions processed faster

Each time you create a crypto transaction, Sumsub extracts the wallet address/hash and tries to match it against the Wallet Address Book. In this case, Sumsub is checking for wallet addresses submitted from other VASPs.

If the match is found, it returns all the available data, which includes information about the VASP the wallet belongs to, its local entity, and more.

For example, our blockchain analytics partners may provide only a general answer about the wallet owner, such as BitPanda. The Sumsub Wallet Address Book allows wallets to be attributed specifically to Bitpanda entities, such as Bitpanda Germany, Bitpanda Custody, and so on.

Step 3. Delete wallet addresses if needed

You can delete wallet addresses by removing transaction ownership using this API method.

curl -X POST \
  'https://api.sumsub.com/resources/kyt/txns/66cd891eefa135789ce5264f/ownership/unconfirmed'