BUbullish
custody

Get Custody Transaction History

Get custody transaction history, requires bearer token in authorization header

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

  • supports pagination

Ratelimited: True - see custody limits

get/v1/wallets/transactions

Request

Query parameters

createdAtDatetime[gte]string date-time

ISO 8601 with millisecond as string

Example:2025-05-20T01:01:01.000Z

start timestamp of period, ISO 8601 with millisecond as string

createdAtDatetime[lte]string date-time

ISO 8601 with millisecond as string

Example:2025-05-20T01:01:01.000Z

end timestamp of period, ISO 8601 with millisecond as string

Response

OK

custodyTransactionIdstring

unique identifier for tracking a deposit or withdrawal

directionstring

direction of transaction from API user's perspective, 'DEPOSIT' or 'WITHDRAWAL'

quantitystring

total quantity of symbol to withdraw including fee in units of symbol, not in smaller denominations (e.g. BTC not Satoshi, ETH not Wei) - quantity received will have fee subtracted.

symbolstring

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

networkstring

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

feestring

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

memostring

memo or destination tag used during deposit to help identify account to credit funds to

createdAtDateTimestring

time of initial transaction

statusstring

one of 'PENDING', 'COMPLETE', 'CANCELLED', 'FAILED'

Example response

[
  {
    "custodyTransactionId": "DB:9e6304a08c9cc2a33e6bc6429a088eae2a6b940c8e312aede3a3780257b9b979",
    "direction": "DEPOSIT",
    "quantity": "100000.00",
    "symbol": "USDC",
    "network": "ETH",
    "fee": "3.00",
    "memo": "925891241",
    "createdAtDateTime": "2022-09-16T07:56:15.000Z",
    "status": "COMPLETE",
    "transactionDetails": {
      "address": "0xb0a64d976972d87b0783eeb1ff88306cd1891f02",
      "blockchainTxId": "0xec557f2c7278d2dae2d98a27b9bd43f386789a4209090cbbd11595f1bed4a4c2",
      "swiftUetr": "b55aa5cd-baa2-4122-8c17-ae9b856ae36a"
    }
  }
]

Changes

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