Get withdrawal quote

get

https://api.cert.zerohash.com/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

participant_code

string

required

length between 6 and 6

The participant the withdrawal will be debited from. 6-character alphanumeric code.

account_group

string

The account_group for the source account. Defaults to the caller's participant_code when omitted.

account_label

string

length ≤ 50

The account_label for the source account. Defaults to general when omitted.

asset

string

required

The asset code of the asset being withdrawn, e.g. BTC.

amount

string

The requested withdrawal amount. Required (and must be positive) unless max_amount is true.

max_amount

string

enum

When true, zerohash will generate a withdrawal for the full available balance of asset in the source account; in that case amount can be omitted. Defaults to false. Accepted as the string "true" or "false".

Allowed:

withdrawal_account_id

string

The withdrawal_account_id of the whitelisted destination account. Required when withdrawal_address is not provided.

withdrawal_address

string

The on-chain address that will receive the crypto asset. Required when withdrawal_account_id is not provided.

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.

no_destination_tag

string

enum

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. Accepted as the string "true" or "false".

Allowed:

Headers

X-SCX-SIGNED

string

required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMP

string

required

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Responses

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

400Bad Request

403Forbidden

404Not Found

500Internal Server Error

503Service Unavailable