FIfireblocks
Staking

Initiate unstake

Submits a chain-specific unstake request.

post/staking/chains/{chainDescriptor}/unstake

Request

Path parameters

chainDescriptor'ATOM_COS' | 'AXL' | 'AXL_TEST' | 'CELESTIA' | 'DYDX_DYDX' | 'ETH' | 'ETH_TEST6' | 'ETH_TEST_HOODI' | 'INJ_INJ' | 'MANTRA' | 'MATIC' | 'OSMO' | 'POL' | 'POL_TEST' | 'SOL' | 'SOL_TEST' | 'STETH_ETH' | 'STETH_ETH_TEST6_DZFA' | 'STETH_ETH_TEST_HOODI' required

Protocol identifier for the staking operation.

Protocol identifier for the unstake staking operation (e.g., SOL/SOL_TEST/MATIC).

Headers

Idempotency-Keystring

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.

Request body

idstring required

id of position to unstake

feestring

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

feeLevel'LOW' | 'MEDIUM' | 'HIGH'

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

txNotestring

The note to associate with the transactions.

amountstring

Amount of tokens to unstake. Only supported for liquid staking (Lido) to enable partial unstaking. For other chains, this field is ignored and the entire position will be unstaked. If not provided, the entire position will be unstaked.

Example request

{
  "id": "b70701f4-d7b1-4795-a8ee-b09cdb5b850d",
  "txNote": "unstake request id b70701f4-d7b1-4795-a8ee-b09cdb5b850d #SOL",
  "feeLevel": "MEDIUM",
  "amount": "7"
}

Response

Unstake request accepted and created.

Changes

No recorded changes to this operation across all 1 revision of this API.