BUbullish
custody

Get a List of Self-Hosted Wallet Verification Attempts

This endpoint provides a history of all Wallet Verification attempts, including those that are completed, pending verification and expired.

Ratelimited: True - see custody limits

get/v1/wallets/self-hosted/verification-attempts

Request

Query parameters

addressstring

an address on the given network

Example:0xb0a64d976972d87b0783eeb1ff88306cd1891f02
destinationIdstring

destination id provided by bullish that uniquely identifies a whitelisted address or account

Example:1560ec0b406c0d909bb9f5f827dd6aa14a1f638884f33a2a3134878102e78038

Response

OK

destinationIdstring required

destination id provided by bullish that uniquely identifies a whitelisted address or account

networkstring required

the network of the native coin or token, e.g. BTC, ETH, SOL

symbolstring required

symbol representing coin or token, e.g. USDC, BTC, ETH, SHIB

addressstring required

an address on the given network

memostring

memo or destination tag that will be used as a reference on transaction

verificationStatus'VERIFIED' | 'PENDING_VERIFICATION' | 'VERIFICATION_EXPIRED' required

The status for the self-hosted wallet verification attempt.

  • VERIFIED - Self-hosted wallet has been verified
  • PENDING_VERIFICATION - pending verification via satoshi test
  • VERIFICATION_EXPIRED - the verification has expired
requestedDepositAmountstring required

User-requested amount for the deposit.

verificationAmountstring required

Bullish specified additional small deposit amount to add to the requestedDepositAmount for wallet verification.

totalDepositAmountstring required

The actual amount that the user should deposit for wallet verification. It is the sum of requestedDepositAmount and verificationAmount.

verificationExpiryTimestring date-time required

ISO 8601 with millisecond as string

Example response

[
  {
    "destinationId": "1560ec0b406c0d909bb9f5f827dd6aa14a1f638884f33a2a3134878102e78038",
    "network": "ETH",
    "symbol": "USDC",
    "address": "0xb0a64d976972d87b0783eeb1ff88306cd1891f02",
    "verificationStatus": "VERIFIED",
    "requestedDepositAmount": "12.3456",
    "verificationAmount": "0.0012",
    "totalDepositAmount": "12.3468",
    "verificationExpiryTime": "2025-05-20T01:01:01.000Z"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.