Withdraw staked funds

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.

POST /staking/chains/{chainDescriptor}/withdraw

TypeScript

TypeScript

const response: Promise<FireblocksResponse<void>> = fireblocks.staking.withdraw(stakingApiWithdrawRequest);

400

{
  "message": "<string>",
  "code": 123
}

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.

Path Parameters

chainDescriptor · enum<string> · required

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

Available options: ATOM_COS, AXL, AXL_TEST, CELESTIA, DYDX_DYDX, ETH, ETH_TEST6, ETH_TEST_HOODI, INJ_INJ, MANTRA, MATIC, OSMO, SOL, SOL_TEST, STETH_ETH, STETH_ETH_TEST6_DZFA, STETH_ETH_TEST_HOODI

Body

application/json

id · string · required

id of position to withdraw

Example:

"b70701f4-d7b1-4795-a8ee-b09cdb5b850d"

fee · string

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

Example:

"7"

feeLevel · enum<string>

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

Available options: LOW, MEDIUM, HIGH

Example:

"MEDIUM"

txNote · string

The note to associate with the transactions.

Example:

"withdraw request id b70701f4-d7b1-4795-a8ee-b09cdb5b850d #ETH"

amount · string

Amount of tokens to withdraw. Only supported for Cosmos chains to enable partial withdrawals. 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.

Example:

"7"

Response

201

Withdraw request accepted and created.