Express

POST

Verify if an address belongs to a wallet

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 Params

  • coin string required
    A cryptocurrency or token ticker symbol.
  • walletId string required
    The wallet ID.

    matches ^[0-9a-f]{32}$

Body Params

object

Request body for verifying if an address belongs to a wallet
  • address string required
    The address to verify
  • keychains array of objects required
    keychains object
    • 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)
  • index number or string
    Address derivation index For Base Address verification, set index to 0
  • coinSpecific object
    Coin-specific address data
    coinSpecific object
    • 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

Responses

200
OK

Response Body

boolean

Returns true if the address belongs to the wallet
400
Bad Request

Response Body

ONE OF

  • error string required
    Human-readable error message
  • requestId string required
    Client request id
  • context object
    Properties that apply to a specific error name
  • name string required
    Error code
500
Addresss Verification Failure

Response Body

ONE OF

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