Withdraw staked funds

post

https://api.fireblocks.io/v1/staking/chains/{chainDescriptor}/withdraw

Withdraws funds that have completed the unbonding period. Typically requires the position to be deactivated first (unstake → unbond → withdraw). Amount and timing vary by chain protocol.

Partial withdrawal is supported for ETH compounding validators (EIP-7251/Pectra) and Cosmos chains via the optional 'amount' field. For ETH compounding validators, the remaining balance must be at least 32 ETH after the withdrawal. For all other chains, omitting 'amount' withdraws the entire available balance.

Path Params

chainDescriptor

string

enum

required

Protocol identifier for the withdraw staking operation (e.g., ATOM_COS/ETH/STETH_ETH).

Body Params

string

required

id of position to withdraw

fee

string

Represents the fee for a transaction, which can be specified as a percentage value. Only one of fee/feeLevel is required.

feeLevel

string

enum

Represents the fee level for a transaction, which can be set as slow, medium, or fast. Only one of fee/feeLevel is required.

Allowed:

txNote

string

The note to associate with the transactions.

amount

string

Amount of tokens to withdraw. Only supported for ETH compounding validators (EIP-7251/Pectra) and Cosmos chains to enable partial withdrawals. For ETH compounding validators, the remaining balance must be at least 32 ETH after withdrawal. For other chains, this field is ignored and the entire available amount will be withdrawn. If not provided, the entire available amount will be withdrawn.

Headers

Idempotency-Key

string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Responses

Language

URL

Loading…

Response

Choose an example:

*/*

application/json

201Withdraw request accepted and created.

400Bad request: missing/invalid fields, unsupported amount, or malformed payload.

403Forbidden: insufficient permissions, disabled feature, or restricted provider/validator.

404Not found: requested resource does not exist (e.g., position, validator, provider, or wallet).

429Rate limit exceeded: slow down and retry later.

500Internal error while processing the request.

defaultError Response