> ## Documentation Index > Fetch the complete documentation index at: https://v3.docs.derive.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Get a wallet's paginated vault request history > Returns the caller's full vault action history (deposits, withdrawals, force-withdrawals, and cancels) across every status — enqueued, requested, applied, cancelled, rejected, or expired — with one row per action at its latest state. Paginated by page and page_size; monetary amounts, prices, and share counts are decimal strings. The wallet parameter must match the authenticated connection. ## OpenAPI ````yaml /openapi.json post /private/get_vault_request_history openapi: 3.1.0 info: title: Derive v3 API version: 0.2.0 description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST. servers: - url: https://api.derive.xyz/v3 description: Production (HTTP POST base) - url: https://testnet.api.derive.xyz/v3 description: Testnet (HTTP POST base) security: [] tags: - name: Subaccounts description: >- List, inspect, and label subaccounts, portfolios, positions, and collateral. - name: Session Keys description: Register, edit, and list delegated signing keys. - name: Account description: Wallet-level account information and settings. - name: Orderbook description: Place, replace, cancel, and query orders, trigger orders, and algos. - name: RFQ description: 'Request-for-quote: send RFQs, quote, and execute block trades.' - name: Vault Shareholders description: >- Deposit into and withdraw from vaults, and track shares, requests, and performance. - name: Vault Curators description: >- Create and operate curated vaults: settle deposit and withdrawal requests, and manage vault metadata. - name: History description: >- Per-account historical records: orders, trades, transfers, and settlements. - name: Market Maker Protection description: Configure, read, and reset market-maker protection. - name: Transfers & Withdrawals description: Move collateral between subaccounts, to other wallets, and on-chain. - name: System description: Rate limits and transaction lookups. - name: Market Data description: Instruments, currencies, tickers, and market-wide feeds. - name: Referrals description: Referral codes and program performance. - name: Other description: Uncategorized. paths: /private/get_vault_request_history: post: tags: - Vault Shareholders summary: Get a wallet's paginated vault request history description: >- Returns the caller's full vault action history (deposits, withdrawals, force-withdrawals, and cancels) across every status — enqueued, requested, applied, cancelled, rejected, or expired — with one row per action at its latest state. Paginated by page and page_size; monetary amounts, prices, and share counts are decimal strings. The wallet parameter must match the authenticated connection. operationId: private_get_vault_request_history requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GetVaultRequestHistoryRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/PaginatedVaultActions' default: description: JSON-RPC error (see Error Codes) components: schemas: GetVaultRequestHistoryRequest: type: object required: - wallet properties: page: default: null type: - integer - 'null' format: uint32 minimum: 0 page_size: default: null type: - integer - 'null' format: uint32 minimum: 0 wallet: description: The shareholder wallet (0x hex). type: string PaginatedVaultActions: type: object required: - actions - pagination - wallet properties: actions: type: array items: $ref: '#/components/schemas/VaultActionResponse' pagination: $ref: '#/components/schemas/Pagination' wallet: type: string VaultActionResponse: description: >- A vault action as surfaced to the requesting user. Monetary fields (amounts, prices, share price) are decimal strings. type: object required: - after_shares - amount - before_shares - creation_timestamp_ms - entry_price - error_reason - event_ts - event_type - exit_price - operation_id - operation_uuid - share_price - shares_delta - shares_requested - status - user_action_hash - vault_nonce - vault_subaccount_id - wallet properties: after_shares: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal amount: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal before_shares: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal creation_timestamp_ms: description: Timestamp the request was created (ms). type: integer format: int64 entry_price: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal error_reason: type: string event_ts: description: Timestamp of this event (ms). type: integer format: int64 event_type: description: >- "vault_deposit" | "vault_withdraw" | "vault_force_withdraw" | "vault_cancel". type: string exit_price: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal operation_id: type: integer format: uint64 minimum: 0 operation_uuid: type: string share_price: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal shares_delta: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal shares_requested: description: >- Non-negative decimal string of the human value (e.g. `"1.5"`), up to 12 fractional digits; a string or JSON number is accepted type: string format: decimal status: description: >- While the action is in the queue, can be one of the following: "enqueued" | "sequencer_applied" | "user_cancel" | "curator_reject" | "protocol_reject" | "expired". Once action is applied in the protocol, the status takes on `BatchStatus` values: "Batching" | "Executing" | "Proving" | "Settling" | "Settled" or an error. type: string user_action_hash: type: string vault_nonce: type: string vault_subaccount_id: type: integer format: uint64 minimum: 0 wallet: type: string Pagination: description: Response envelope for paginated RPCs. type: object required: - count - num_pages properties: count: type: integer format: uint64 minimum: 0 num_pages: type: integer format: uint64 minimum: 0 ```` ## Related topics - [List a wallet's pending vault requests](/api-reference/vault-shareholders/list-a-wallets-pending-vault-requests.md) - [Get a vault's economic action history](/api-reference/vault-shareholders/get-a-vaults-economic-action-history.md) - [Get perpetual funding history for a subaccount](/api-reference/history/get-perpetual-funding-history-for-a-subaccount.md)