BUbullish
custody

Get Withdrawal Instructions for Crypto

Get crypto withdrawal instructions, requires bearer token in authorization header. Please note that all withdrawal addresses must be whitelisted via the Bullish website before any digital asset withdrawals can be processed.

Please note that Custody endpoints utilize a non-multiplied asset format for long decimal assets like SHIB and PEPE, ensuring consistency with real-world asset representation. This differs from Trading endpoints, which use a multiplied asset format, such as SHIB1M and PEPE1M. For more information, please see help center

Ratelimited: True - see custody limits

get/v1/wallets/withdrawal-instructions/crypto/{symbol}

Request

Path parameters

symbolstring required

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

Example:USDC

Query parameters

signedboolean

Whether this destination has been signed by the user. Some operations such as withdrawal requires the destination to be signed.

Example:true
lockedboolean

Whether this destination is currently in a withdrawal lock period. Addresses are locked upon whitelisting for a 24-hour security period.

Example:true

Response

OK

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

feestring required

withdrawal fee charged in units of symbol, not in smaller denominations (e.g. BTC not Satoshi, ETH not Wei)

memostring

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

labelstring required

descriptive label of destination provided by user

destinationIdstring required

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

vaspNamestring

The name of the hosting VASP of the wallet. This is only applicable for HOSTED wallets.

userWalletType'HOSTED' | 'SELF_HOSTED' | 'UNKNOWN' required

The host type of the wallet. HOSTED wallet uses a custodial wallet service, SELF_HOSTED wallet is a non-custodial wallet.

signedboolean required

Whether this destination has been signed by the user. Some operations such as withdrawal requires the destination to be signed.

lockedboolean

Whether this destination is currently in a withdrawal lock period. Addresses are locked upon whitelisting for a 24-hour security period.

lockExpiryDateTimestring date-time

ISO 8601 Zulu timestamp of when the withdrawal lock period expires. Applies only when locked is true.

Example response

[
  {
    "network": "ETH",
    "symbol": "USDC",
    "address": "0xb0a64d976972d87b0783eeb1ff88306cd1891f02",
    "fee": "3.00",
    "label": "Our cold wallet",
    "destinationId": "1560ec0b406c0d909bb9f5f827dd6aa14a1f638884f33a2a3134878102e78038",
    "minimumWithdrawalAmount": "0.01",
    "vaspName": "Bullish",
    "userWalletType": "HOSTED",
    "signed": true,
    "locked": true,
    "lockExpiryDateTime": "2026-06-24T12:00:00Z"
  }
]

Changes

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