---
title: "Get Custody Transaction History"
method: GET
path: "/v1/wallets/transactions"
tags: ["custody"]
---

# Get Custody Transaction History

`GET /v1/wallets/transactions`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v1/wallets/transactions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v1/wallets/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

Get custody transaction history, requires [bearer token](/rest/authentication#add-authenticated-request-header) 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](https://bullishexchange.atlassian.net/wiki/spaces/BHC/pages/20807684/Understanding+Multiplied+Assets+PEPE1M+and+SHIB1M)

- [supports pagination](/rest/general/pagination)

**Ratelimited:** `True` - see [custody limits](/rest/general/rate-limits)

## Query parameters

- `createdAtDatetime[gte]` string, date-time: ISO 8601 with millisecond as string
- `createdAtDatetime[lte]` string, date-time: ISO 8601 with millisecond as string

## Response `200`

OK

- CustodyHistory[]
  - `custodyTransactionId` string: unique identifier for tracking a deposit or withdrawal
  - `direction` string: direction of transaction from API user's perspective, 'DEPOSIT' or 'WITHDRAWAL'
  - `quantity` string: 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.
  - `symbol` string: symbol representing coin or token, e.g. USDC, BTC, ETH, SHIB
  - `network` string: the network of the native coin or token, e.g. BTC, ETH, SOL
  - `fee` string: withdrawal fee charged in units of symbol, not in smaller denominations (e.g. BTC not Satoshi, ETH not Wei)
  - `memo` string: memo or destination tag used during deposit to help identify account to credit funds to
  - `createdAtDateTime` string: time of initial transaction
  - `status` string: one of 'PENDING', 'COMPLETE', 'CANCELLED', 'FAILED'
  - `transactionDetails` CustodyTransactionDetails
    - `address` string: crypto network address
    - `blockchainTxId` string: transaction id on chain
    - `swiftUetr` string: unique end-to-end-transaction reference for swift transactions

## Other responses

- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bullish/apis/bullish-trading-api.md) - [All operations](https://skmtc.dev/bullish/apis/bullish-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bullish/apis/bullish-trading-api/revisions/df5d69ccedcf?raw)