---
title: "Get withdrawal quote"
method: GET
path: "/withdrawals/locked_network_fee"
tags: ["Withdrawals"]
---

# Get withdrawal quote

`GET /withdrawals/locked_network_fee`

Returns a locked network fee quote for a planned crypto withdrawal. The returned `withdrawal_quote_id` is valid for 30 seconds and must be passed to POST /withdrawals/execute to complete the withdrawal. Exactly one of `withdrawal_account_id` or `withdrawal_address` must be supplied; if `max_amount` is `false` (the default), `amount` is required.

## Query parameters

- `participant_code` string, required
- `account_group` string
- `account_label` string
- `asset` string, required
- `amount` string
- `max_amount` 'true' | 'false'
- `withdrawal_account_id` string
- `withdrawal_address` string
- `destination_tag` string
- `no_destination_tag` 'true' | 'false'

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Successfully retrieved locked network fee quote. including `withdrawal_quote_id`, `net_withdrawal_quantity`, and the locked network/withdrawal fees.

- GetLockedNetworkFeeResponse
  - `message` LockedNetworkFeeEntity — Locked network fee quote returned by GET /withdrawals/locked_network_fee. The quote is valid for 30 seconds and must be referenced by `withdrawal_quote_id` when calling POST /withdrawals/execute.
    - `participant_code` string — The participant the withdrawal will be debited from.
    - `account_group` string — The `account_group` for the source account the withdrawal will be debited from.
    - `account_label` string — The `account_label` for the source account the withdrawal will be debited from.
    - `asset` string — The asset being withdrawn.
    - `amount` string — The amount requested for the withdrawal.
    - `max_amount` boolean — When `true`, the quote was generated for the full available balance of `asset` in the source account rather than a specific `amount`. Defaults to `false`.
    - `withdrawal_account_id` string — The whitelisted withdrawal account identifier associated with the destination address. Empty string when the quote was requested by raw `withdrawal_address`.
    - `withdrawal_address` string — The on-chain address that will receive the crypto asset. Echoes the `withdrawal_address` supplied on the request.
    - `destination_tag` string — The destination tag or memo ID associated with the transaction. Required when the asset is EOS, XLM, or XRP and `no_destination_tag` is false. Empty string when not applicable.
    - `no_destination_tag` boolean — Whether the destination address requires a destination tag. Required for tag-based assets (EOS, XLM, XRP); zerohash requires `no_destination_tag` to be `false` for EOS.
    - `withdrawal_quote_id` string, uuid — Unique ID for this locked network fee quote. Supply this value to POST /withdrawals/execute to complete the withdrawal. Quotes are valid for 30 seconds.
    - `network_fee` string — The network fee quantity that will be deducted from the requested withdrawal amount.
    - `network_fee_notional` string — The network fee notional value in USD.
    - `net_withdrawal_quantity` string — The asset quantity that will arrive on-chain: requested withdrawal amount minus the network fee.
    - `net_withdrawal_notional` string — The notional value in USD that will arrive on-chain: `amount_notional` minus `network_fee_notional`.
    - `amount_notional` string — The notional USD value of the requested withdrawal amount.
    - `withdrawal_fee` string — The withdrawal fee (denominated in the withdrawn asset) that will be charged by zerohash. Returns "0" when no withdrawal fee applies.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)