BUbullish
custody

Initiate Self-Hosted Wallet Verification

This endpoint is used for initiating wallet verification requests.

Note: users will have 24 hours to complete the wallet verification by sending the exact total amount to the Bullish deposit address provided.

Ratelimited: True - see custody limits

post/v1/wallets/self-hosted/initiate

Request

Request body

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

labelstring required

descriptive label of destination provided by user

requestedDepositAmountstring required

User-requested amount for the deposit.

Example request

{
  "network": "ETH",
  "symbol": "USDC",
  "address": "0xb0a64d976972d87b0783eeb1ff88306cd1891f02",
  "label": "Our cold wallet",
  "requestedDepositAmount": "12.3456"
}

Response

OK

destinationIdstring

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

networkstring

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

symbolstring

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

depositAddressstring

The address of the Bullish trading account that the user should deposit to during a self hosted deposit attempt.

depositMemostring

The memo or destination tag of the Bullish trading account that the user should deposit to during a self hosted deposit attempt.

requestedDepositAmountstring

User-requested amount for the deposit.

verificationAmountstring

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

totalDepositAmountstring

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

verificationExpiryTimestring date-time

ISO 8601 with millisecond as string

Example response

{
  "destinationId": "1560ec0b406c0d909bb9f5f827dd6aa14a1f638884f33a2a3134878102e78038",
  "network": "ETH",
  "symbol": "USDC",
  "depositAddress": "0xb0a64d976972d87b0783eeb1ff88306cd1891f02",
  "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.