Wallet Verification API

API for verifying wallet ownership

Wallet Verification

Quick Sync offers an API designed to verify wallet ownership. The verification process generates a short-lived token, which can be used to create or join a session. For more details, refer to the Session API.

API is currently under active development and is subject to change. We recommend checking the documentation regularly and subscribing to updates to stay informed about any changes, deprecations, or new features that could impact your implementation.

Verifying Wallet Ownership

1. Obtain a Nonce Message – Request a nonce message from the server. This message is a temporary, unique identifier used for verification.

2. Sign the Message – Use the desired wallet within your frontend application to sign the nonce message.

3. Submit a Verification Request – Send a request containing the wallet address, signed message, and signature to complete the verification process.

Currently, the API supports only ERC-20 wallets, but support for additional wallet types will be added in the future.

Get nonce message.

get

Get a nonce message used for verification.

Responses

200

Success

text/plainapplication/jsontext/json

get

HTTPcURLJavaScriptPython

GET /v1/wallet-proof/nonce HTTP/1.1
Host: api.quicksync.me
Accept: */*

200

Success

{
  "nonce": 1,
  "message": "text"
}

Verify wallet.

post

Verify wallet given a wallet address, nonce message, and signature.

Query parameters

chainstringOptionalDefault: Ethereum

Body

application/jsontext/jsonapplication/*+json

walletAddressstring | nullableOptional

messagestring | nullableOptional

signaturestring | nullableOptional

Responses

200

Success

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

post

HTTPcURLJavaScriptPython

POST /v1/wallet-proof/verify HTTP/1.1
Host: api.quicksync.me
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "walletAddress": "text",
  "message": "text",
  "signature": "text"
}

application/jsontext/jsonapplication/*+json

{
  "token": "text"
}