Sign in

v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB
Counterparty

Verify self-hosted wallet ownership

post/counterparty/self-hosted/verify-wallet

Request body

userIdstring uuid

Owner user id. Provide exactly one of userId / businessId.

businessIdstring uuid

Owner business id. Provide exactly one of userId / businessId.

counterpartyIdstring required
method'WALLET_SIGNATURE' required

EIP-191 wallet ownership proof. SumSub liveness uses POST /counterparty/wallet-verification/sumsub/initiate instead.

signaturestring required

Cryptographic proof over message. EVM — EIP-191 hex; Bitcoin — compact base64 (65 bytes) or Electrum/Sparrow armor; Solana — Ed25519 base58.

signed_addressstring required
signatureScheme'bip137' | 'electrum'

Bitcoin message-signing format. Defaults to bip137 (Trezor, Ledger, Bitcoin Core). Use electrum for Electrum and Sparrow.

messagestring required

The exact UTF-8 string the wallet signed. After extracting the embedded date, the text must match character-for-character:

I am verifying ownership of the wallet address {signed_address} as {ownerId}. This message was signed on {DD/MM/YYYY} to confirm my control over this wallet.

{signed_address} is the same value as in this request body. {ownerId} is the same value as userId or businessId (whichever owner field you sent). {DD/MM/YYYY} is the calendar date in UTC and must be yesterday, today, or tomorrow relative to the server's current UTC date when the request is processed.

Response

OK

status'VERIFIED' required
walletVerificationIdstring uuid required

Example response

{
  "status": "VERIFIED",
  "walletVerificationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "counterparty": {
    "counterpartyId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "userId": "8ae384b7-ce6b-4b00-a4ec-1bcb9a5e5d1d",
    "identityType": "CONSUMER",
    "counterpartyAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "network": "Eth",
    "type": "SELF_HOSTED",
    "subType": "OWNED",
    "createdAt": "2026-05-10T08:00:00.000Z",
    "updatedAt": "2026-05-14T12:00:00.000Z"
  }
}