Ctrl+K

Sign staking transaction

post/api/staking/v1/{coin}/wallets/{walletId}/requests/{stakingRequestId}/transactions/{stakingTransactionId}

Use to act on a transaction like sending a transaction

Path Parameters

  • coinstringRequired
    The staking asset.
    Enum: ADA ASI ATOM AVAXC AVAXP BABY BERA BLD BSC BTC COREDAO COREUM CRONOS CSPR DOT EIGEN ETH HASH INJECTIVE MATIC NEAR OSMO POL POLYX RETH-ROCKET SEI SOMI SOL STORY STX SUI SUI:WAL TAO TIA TON TRX WETH WCT WFLR ZETA
  • walletIdstringRequired
    The wallet ID.
    Example: 59cd72485007a239fb00282ed480da1f
  • stakingRequestIdstring<uuid>Required
    The ID for the staking request used in the path.
  • stakingTransactionIdstringRequired
    The ID for the staking request transaction.

Request Body

One of
halfSigned object
A half-signed transaction object.
contractSequenceId string
The contract sequence ID of the transaction.
eip1559 object
operationHash string
expireTime string
signature string
comment string
txHex string
Raw transaction hex.

200 Response

One of
id string
The staking transaction ID.
stakingRequestId string required
The staking request ID.
transactionType string required
The transaction type (delegate).
Allowed values: delegate reward undelegate withdraw_undelegated authorize
txHash string
The transaction hash.
createdDate string <date-time>required
The date the transaction was created.
status string required
The status of the transaction, either NEW, READY, INITIATED, CONFIRMED, or REJECTED.
Allowed values: WAITING READY SENDING PENDING_APPROVAL PENDING_BITGO_TRUST_APPROVAL REJECTED PENDING FAILED CONFIRMED VALIDATOR_ACTIVATING DELAYED_READY
statusModifiedDate string <date-time>required
The last date the status changed.
error string
The reason the transaction failed.
rawError string
Raw internal error message if available.
amount string required
The transaction Amount in base units (i.e. Wei for ETH).
Example: 2000000
Match pattern: ^-?\d+$
delegationId string required
The staking delegation the transaction is acting on.
pendingApprovalId string
Pending Approval ID
transferId string
Transfer ID
txRequestId string
Transaction Request ID for the Transaction Request API
coin string
The coin associated with this staking transaction.
buildParams object
sequenceId string <uuid>
Unique sequence identifier
recipients array[object]
Recipient build params data
stakingParams object
gasPrice string
The gas price in base units.
gasLimit string
The gas limit in base units.
stakingOptionsOne of
Union of concrete staking option types. One of the concrete option schemas below.
type string
The transaction type (internal use).
senderWalletId string
The wallet ID of the sender.
feeRate integer
Fee rate (used in UTXO chains).
unspents array[string]
List of unspent transaction outputs (UTXOs).
silentSignature boolean
Indicates if silent signature is enabled.
unstakingParams object
delegationIds array[string]
Multiple delegation IDs associated with this transaction
delegations array[object]
Delegation objects associated with this transaction
id string
The staking request ID.
coin string
The staking asset.
walletId string
The ID of the wallet that the delegation is tied to.
delegationAddress string
The delegation address.
validatorAddress string
The validator address of the delegation.
provider string
The staking provider backing the delegation.
providerType string
The staking provider backing the delegation. This field is used in bitgo UI to map provider with icon
withdrawalAddress string
The withdrawal address.
delegated string
The delegation amount.
status string
The status of the delegation.
Allowed values: PENDING FAILED REJECTED ACTIVE COMPLETE
rewards string
The amount of rewards received over the lifetime.
lockedRewards string
The amount of locked rewards received.
pendingUnstake string
The amount that is pending unstake.
pendingStake string
The amount that is pending stake.
reserved string
The amount that is reserved for this delegation.
pendingReserved string
The amount that is pending reservation for this delegation.
apy string
The estimated reward APY or APR if rewards are not compounding.
unstakeable boolean
Indicates whether the delegation can currently be unstaked.
propertiesOne of
claimable
boolean or null
Whether the delegation has claimable rewards.
pendingClaimRewards
string or null
Rewards that are pending claim (stringified bigint).
claimableRewards
string or null
Rewards that are currently claimable (stringified bigint).
switchable
boolean or null
Whether the delegation can be switched to another validator.
maxSwitch
string or null
Maximum amount allowed to switch (stringified bigint).
minSwitch
string or null
Minimum amount required to switch (stringified bigint).
permissionAttributes object
Permission attributes for the staking wallet.
spendableAttributes object
Spendable attributes available for a wallet’s staking operations.
restaking
boolean or null
Whether this delegation is restaking rewards automatically.
rewardPairs array[object]
Reward token breakdown for Eigen-like or ETH restaking.
rewardCoin
string or null
The reward coin associated with this delegation.

400 Response

error string
errorName string
reqId string
context object

401 Response

error string
errorName string
reqId string
context object

403 Response

error string
errorName string
reqId string
context object

404 Response

error string
errorName string
reqId string
context object

409 Response

error string
errorName string
reqId string
context object

500 Response

error string
errorName string
reqId string
context object