Ctrl+K

Verify if an address belongs to a wallet

post/api/v2/{coin}/wallet/{walletId}/iswalletaddress

This endpoint verifies whether a given address belongs to the specified wallet. It performs cryptographic verification, checking address derivation against wallet keychains and configuration.

Returns true if the address belongs to the wallet. Throws an error if verification fails or parameters are invalid.

To verify a baseAddress, set baseAddress and address to the base address of the wallet.

Due to architecture limitations, forwarder version 0 addresses cannot be verified and will return true without verification.

Verifying custodial wallet addresses is not supported.

Path Parameters

  • coinstringRequired
    A cryptocurrency or token ticker symbol.
    Example: btc
  • walletIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$

Request Body

address string required
The address to verify
keychains array[object] required
Keychains for cryptographic verification Can be retrieved from GET /api/v2/{coin}/key/{id}
pub string required
ethAddress string
Ethereum address (required for V1, V2, V4 ETH wallets base address verification)
commonKeychain string
Common keychain (required for wallets version 3, 5, 6)
baseAddress string
Base address of the wallet (wallet.coinSpecific.baseAddress)
walletVersion number
Wallet version (wallet.coinSpecific.walletVersion)
indexOne of
Address derivation index For Base Address verification, set index to 0
coinSpecific object
Coin-specific address data
baseAddress string
Base address (wallet.coinSpecific.baseAddress)
feeAddress string
Fee address for v4 forwarders (wallet.coinSpecific.feeAddress)
forwarderVersion number
Forwarder version (address.coinSpecific.forwarderVersion, required for forwarder addresses only)
salt string
Salt for address derivation ForwarderAddress: address.coinSpecific.salt BaseAddress: wallet.coinSpecific.salt
impliedForwarderVersion number
Implied forwarder version
format string
Format for the address
rootAddress string
Root address for coins that use root address

200 Response

boolean
Returns true if the address belongs to the wallet

400 Response

allOf All of
object
error string required
Human-readable error message
requestId string required
Client request id
object
context object
Properties that apply to a specific error name
name string required
Error code

500 Response

allOf All of
object
error string required
Human-readable error message
requestId string required
Client request id
object
context object
Properties that apply to a specific error name
name string required
Error code