> ## Documentation Index > Fetch the complete documentation index at: https://docs.deribit.com/llms.txt > Use this file to discover all available pages before exploring further. # private/cancel_withdrawal > Cancels a pending withdrawal request. This method allows you to cancel a withdrawal that has not yet been processed. Once a withdrawal is processed, it cannot be cancelled. **📖 Related Article:** [Managing Withdrawals](https://docs.deribit.com/articles/managing-withdrawals-api) **Scope:** `wallet:read_write` [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fcancel_withdrawal) ## OpenAPI ````yaml /specifications/deribit_openapi.json get /private/cancel_withdrawal openapi: 3.0.0 info: title: Deribit API version: 2.1.1 servers: - url: https://test.deribit.com/api/v2 security: [] tags: - name: WebSocket Only description: Can only be used over websockets. - name: Public description: Public methods can be used without authentication. - name: Private description: >-

Private methods require authentication. All requests must include a valid OAuth2 token.

A token can be requested using the /public/auth method.

When using the websockets protocol, the token must be included as a parameter access_token in the message. When using REST (HTTP GET), the token may also be passed in the Authorization header.

- name: Authentication - name: Session Management - name: Subscription Management description: >- Subscription works as [notifications](#notifications), so users will automatically (after subscribing) receive messages from the server. Overview for each channel response format is described in [subscriptions](#subscriptions) section. - name: Account Management - name: Trading - name: Market Data - name: Wallet - name: Chat - name: lsp description: >- Methods and notifications for the Liquidity Support Program (LSP), the mechanism that assigns risk from liquidated positions to designated LSP participant subaccounts before falling back to auto-deleveraging (ADL). paths: /private/cancel_withdrawal: get: tags: - Wallet - Private description: >+ Cancels a pending withdrawal request. This method allows you to cancel a withdrawal that has not yet been processed. Once a withdrawal is processed, it cannot be cancelled. **📖 Related Article:** [Managing Withdrawals](https://docs.deribit.com/articles/managing-withdrawals-api) **Scope:** `wallet:read_write` [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fcancel_withdrawal) parameters: - name: currency required: true in: query schema: $ref: '#/components/schemas/currency' description: > The currency symbol. **📖 Related Article:** [Using the currency Parameter](https://docs.deribit.com/articles/currency-parameter) - in: query name: id required: true schema: type: number example: 1 description: The withdrawal id requestBody: content: application/json: examples: request: value: jsonrpc: '2.0' id: 7420 method: private/cancel_withdrawal params: currency: BTC id: 1 description: JSON-RPC Request Example description: JSON-RPC request body responses: '200': $ref: '#/components/responses/PrivateWithdrawResponse' components: schemas: currency: enum: - BTC - ETH - USDC - USDT - EURR type: string description: Currency, i.e `"BTC"`, `"ETH"`, `"USDC"` PrivateWithdrawResponse: properties: jsonrpc: type: string enum: - '2.0' description: The JSON-RPC version (2.0) id: type: integer description: The id that was sent in the request result: oneOf: - $ref: '#/components/schemas/withdrawal' - $ref: '#/components/schemas/coinbase_withdrawal_result' required: - result - jsonrpc type: object withdrawal: properties: address: $ref: '#/components/schemas/currency_address' amount: $ref: '#/components/schemas/currency_amount' confirmed_timestamp: type: integer example: 1536569522277 nullable: true description: >- The timestamp (milliseconds since the Unix epoch) of withdrawal confirmation, `null` when not confirmed created_timestamp: $ref: '#/components/schemas/timestamp' currency: $ref: '#/components/schemas/currency' fee: $ref: '#/components/schemas/fee' id: type: integer example: 1 description: Withdrawal id in Deribit system priority: type: number example: 1 description: Id of priority level state: $ref: '#/components/schemas/withdrawal_state' transaction_id: $ref: '#/components/schemas/currency_transaction_id' updated_timestamp: $ref: '#/components/schemas/timestamp' nonce: type: string description: Optional idempotency nonce if provided in the request required: - currency - address - amount - state - transaction_id - updated_timestamp type: object coinbase_withdrawal_result: properties: id: type: string example: 0190a1b2-7c3d-7e5f-8a9b-0c1d2e3f4a5b description: Unique identifier (UUID7) of the withdrawal transfer_idem: type: string example: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d description: >- Idempotency identifier of the transfer at the custodian. Absent until the withdrawal has been submitted to the custodian — for example while the withdrawal is still `prepared` and awaiting email confirmation. currency: $ref: '#/components/schemas/currency' state: type: string enum: - prepared - awaiting_second_email - unconfirmed - completed - cancelled description: State of the withdrawal amount: type: number example: 0.5 description: Amount of the withdrawal, in the given currency address: type: string example: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e' description: >- Destination of the withdrawal: the on-chain address, or the CTN counterparty identifier for a CTN withdrawal transaction_id: type: string description: >- Hash of the on-chain transaction. Absent until the transaction has been broadcast. network: type: string example: networks/ethereum-mainnet description: >- Network resource name of the destination (e.g. `"networks/ethereum-mainnet"`); absent for CTN withdrawals network_display_name: type: string example: Ethereum description: >- Human-readable name of the network (e.g. `"Ethereum"`); absent for CTN withdrawals destination_tag: type: string description: Destination tag / memo of the withdrawal; absent when not set payment_id: type: string description: Payment identifier assigned by the custodian; absent when not set source_ctn_id: type: string description: >- CTN counterparty identifier of the source; present for CTN withdrawals destination_ctn_id: type: string description: >- CTN counterparty identifier of the destination; present for CTN withdrawals created_timestamp: $ref: '#/components/schemas/timestamp' updated_timestamp: $ref: '#/components/schemas/timestamp' confirmed_timestamp: $ref: '#/components/schemas/timestamp' clearance_state: type: string example: success description: >- Compliance clearance state of the withdrawal; absent while no clearance decision has been recorded note: type: string description: Note attached to the withdrawal; empty string when not set required: - id - currency - state - amount - created_timestamp - updated_timestamp - note type: object description: >- Result of a withdrawal for a Coinbase wallet type account. Returned instead of `withdrawal` for Coinbase wallet type users. Fields that are not set are omitted from the response. currency_address: example: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa type: string description: Address in proper format for currency currency_amount: example: 1 type: number description: Amount of funds in given currency timestamp: example: 1536569522277 type: integer description: The timestamp (milliseconds since the Unix epoch) fee: example: 0.000023 type: number description: Fee in currency withdrawal_state: enum: - unconfirmed - confirmed - cancelled - completed - interrupted - rejected type: string description: >- Withdrawal state, allowed values : `unconfirmed`, `confirmed`, `cancelled`, `completed`, `interrupted`, `rejected` currency_transaction_id: nullable: true example: 1b1fb5568515e2b79503501e3d3680b2d0838d5dfc2d15a04eb8cd9fbbe0b572 type: string description: >- Transaction id in proper format for currency, `null` if id is not available responses: PrivateWithdrawResponse: content: application/json: schema: $ref: '#/components/schemas/PrivateWithdrawResponse' examples: response: value: jsonrpc: '2.0' id: 7420 result: address: 2NBqqD5GRJ8wHy1PYyCXTe9ke5226FhavBz amount: 0.5 confirmed_timestamp: null created_timestamp: 1550571443070 currency: BTC fee: 0.0001 id: 1 priority: 0.15 state: cancelled transaction_id: null updated_timestamp: 1550571443070 description: Response example coinbaseResponse: value: jsonrpc: '2.0' id: 6931 result: id: 0190a1b2-7c3d-7e5f-8a9b-0c1d2e3f4a5b transfer_idem: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d currency: ETH state: unconfirmed amount: 0.5 address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e' network: networks/ethereum-mainnet network_display_name: Ethereum created_timestamp: 1719993033041 updated_timestamp: 1719993033041 note: '' description: Coinbase response example description: Success response ```` ## Related topics - [Managing Withdrawals](/articles/managing-withdrawals-api.md) - [private/get_withdrawals](/api-reference/wallet/private-get_withdrawals.md) - [private/coinbase/estimate_withdrawal_fee](/api-reference/wallet/private-estimate_withdrawal_fee.md) - [private/set_coinbase_subaccount_withdrawals_allowed](/api-reference/wallet/private-set_coinbase_subaccount_withdrawals_allowed.md) - [private/cancel_transfer_by_id](/api-reference/wallet/private-cancel_transfer_by_id.md)