---
title: "Get vault transfers"
method: GET
path: "/vaults/transfers"
tags: ["Vaults"]
---

# Get vault transfers

`GET /vaults/transfers`

Get deposits and withdrawals related to the given vault.

## Query parameters

- `address` string, required

## Response `200`

OK

- object
  - `results` object[] — Array of results
    - `account` string — Starknet Account address
    - `amount` string — Transferred amount
    - `auto_withdrawal_fee` string — Fee for auto withdrawal in USDC
    - `bridge` '' | 'STARKGATE' | 'LAYERSWAP' | 'RHINOFI' | 'HYPERLANE'
    - `counterparty` string — Counterparty address
    - `created_at` integer — Unix Millis timestamp transfer was created on L2
    - `direction` 'IN' | 'OUT'
    - `external_account` string — External chain account address
    - `external_chain` string — External chain used for the transfer
    - `external_txn_hash` string — Transaction hash on the external chain
    - `failure_reason` string — Reason for transfer failure
    - `id` string — Transfer auto-generated ID
    - `kind` 'DEPOSIT' | 'WITHDRAWAL' | 'UNWINDING' | 'VAULT_DEPOSIT' | 'VAULT_WITHDRAWAL' | 'AUTO_WITHDRAWAL' | 'AIRDROP'
    - `last_updated_at` integer — Unix Millis timestamp transfer was last updated on L2
    - `socialized_loss_factor` string — Withdrawal's socialized loss factor
    - `status` 'PENDING' | 'AVAILABLE' | 'COMPLETED' | 'FAILED'
    - `token` string — Transferred token name
    - `txn_hash` string — Transaction hash on Paradex chain
    - `vault_address` string — Vault address
    - `vault_unwind_completion_percentage` string — Vault unwind completion percentage

## Other responses

- `400` — Bad Request

## Changes

- **2026-07-17** `f1370c46e9e8` — 3 warning
  - added the new `BLOCK_TRADE_REPLAYED_SIGNATURE` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `EVM_VAULT_OPERATORS_DISABLED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `VAULT_DATA_PRIVATE` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
- **2026-06-09** `43b81de9b079` — 3 info
  - removed the `INVALID_RHINOFI_QUOTE` enum value from the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - removed the `INVALID_RHINOFI_QUOTE_COMMIT` enum value from the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - removed the `INVALID_RHINOFI_REQUEST` enum value from the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
- **2026-05-21** `7861dbd35cf5` — 2 warning
  - added the new `IP_NOT_ALLOWED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `MARKET_NOT_SETTLED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
- …earlier changes not shown

[Full history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/vaults/transfers/get.md)

---

[API](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2.md) · [All operations](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tradeparadex/paradex-rest-api-2/revisions/a73698fdee53/schema)