Initiate or add to existing stake

post

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

Creates a new staking position and returns its unique ID. For Ethereum compounding validator (EIP-7251): when the 'id' of an existing compounding validator position is provided, adds to that position; otherwise creates a new position. For Ethereum legacy validator: creates a new position regardless of existing delegations. For Cosmos chains and Ethereum liquid staking (Lido): automatically add to existing positions for the same validator provider and same vault account if one exists, otherwise create a new position. For Solana and Polygon: always create new positions regardless of existing delegations.

Path Params

chainDescriptor

string

enum

required

Protocol identifier for the stake staking operation (e.g., ATOM_COS/AXL/CELESTIA).

Body Params

vaultAccountId

string

required

The Fireblocks vault account ID that will source the funds for staking.

providerId

string

enum

required

The unique identifier of the staking provider

stakeAmount

string

required

The amount of tokens to stake. The amount may be truncated to match the chain's decimal precision requirements.

txNote

string

Optional note or comment to associate with the stake transaction. This note will be included in transaction records and can be used for tracking or audit purposes.

fee

string

Optional transaction fee. Controls the priority and cost of the blockchain transaction. Only one of 'fee' or 'feeLevel' should be provided; if both are specified, 'feeLevel' takes precedence.

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:

chainDescriptor

string

Protocol identifier for the staking operation

string

Applies only to Ethereum compounding validator staking (Pectra/EIP-7251). The ID of an existing staking position to add additional stake to. When provided, adds stake to the specified position instead of creating a new one. Requires 'isCompoundingValidator' to be true.

isCompoundingValidator

boolean

Applies only to Ethereum staking. Indicates whether to use a compounding validator (see Pectra/EIP-7251). When true, creates a position that supports adding additional stake via the 'id' parameter. If not provided, defaults to false and a legacy (non-compounding) validator will be used.

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

201Stake 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