Get position details

Returns full details for a single staking position: amounts, rewards, status, chain, and vault.

GET /staking/positions/{id}

TypeScript

TypeScript

const response: Promise<FireblocksResponse<Delegation>> = fireblocks.staking.getDelegationById(stakingApiGetDelegationByIdRequest);

200

{
  "id": "b70701f4-d7b1-4795-a8ee-b09cdb5b850a",
  "vaultAccountId": "2",
  "validatorName": "FwR3P......tT59f",
  "providerName": "Kiln",
  "chainDescriptor": "SOL",
  "amount": "0.05",
  "rewardsAmount": "0.000856038",
  "dateCreated": "2023-07-13T15:55:34.256Z",
  "dateUpdated": "2023-07-13T15:55:34.256Z",
  "status": "active",
  "relatedTransactions": [
    {
      "txId": "b70601f4-d7b1-4795-a8ee-b09cdb4r850d",
      "completed": true
    },
    {
      "txId": "c80601f4-d7b1-4795-a8ee-b09cdb5b450c",
      "completed": false
    }
  ],
  "validatorAddress": "FwR3PbjS5iyqzLiLugrBqKSa5EKZ4vK9SKs7eQXtT59f",
  "providerId": "kiln",
  "availableActions": [
    "unstake"
  ],
  "inProgress": true,
  "blockchainPositionInfo": {
    "stakeAccountAddress": "3Ru67FyzMTcdENmmRL4Eve4dtPd6AdpuypR21q5EQCdq"
  },
  "inProgressTxId": "c80601f4-d7b1-4795-a8ee-b09cdb5b450c",
  "relatedRequests": [
    {
      "status": "deactivating",
      "inProgress": false,
      "amount": "0.05",
      "txId": "c80601f4-d7b1-4795-a8ee-b09cdb5b450c"
    }
  ]
}

Path Parameters

id · string · required

Unique identifier of the staking position.

Response

200

application/json

Position retrieved successfully.

id · string · required

The unique identifier of the staking position

Example:

"b70701f4-d7b1-4795-a8ee-b09cdb5b850a"

vaultAccountId · string · required

The source vault account to stake from

Example:

"2"

validatorName · string · required

The destination validator address name

Example:

"FwR3P......tT59f"

providerName · string · required

The destination validator provider name

Example:

"Kiln"

chainDescriptor · string · required

The protocol identifier (e.g. "ETH"/ "SOL") to use

Example:

"SOL"

amount · string · required

Total value of the staking position. For Solana, Lido and Ethereum (compounding validator): includes the original stake plus accumulated rewards. For MATIC, Cosmos and Ethereum (legacy validator): refers to the amount currently staked.

Example:

"0.05"

rewardsAmount · string · required

The amount staked in the position, measured in the staked asset unit.

Example:

"0.000856038"

dateCreated · string<date-time> · required

When was the request made (ISO Date).

Example:

"2023-07-13T15:55:34.256Z"

dateUpdated · string<date-time> · required

When has the position last changed (ISO Date).

Example:

"2023-07-13T15:55:34.256Z"

status · string · required

The current status.

Example:

"active"

relatedTransactions · object[] · required

An array of transaction objects related to this position. Each object includes a 'txId' representing the transaction ID and a 'completed' boolean indicating if the transaction was completed.

Show child attributes

Example:

[
  {
    "txId": "b70601f4-d7b1-4795-a8ee-b09cdb4r850d",
    "completed": true
  },
  {
    "txId": "c80601f4-d7b1-4795-a8ee-b09cdb5b450c",
    "completed": false
  }
]

validatorAddress · string · required

The destination address of the staking transaction.

Example:

"FwR3PbjS5iyqzLiLugrBqKSa5EKZ4vK9SKs7eQXtT59f"

providerId · enum<string> · required

The unique identifier of the staking provider

Available options: kiln, figment, lido, p2p, blockdaemon, galaxy, pierTwo, kraken

Example:

"kiln"

availableActions · string[] · required

An array of available actions that can be performed. for example, actions like "unstake" or "withdraw".

Example:

["unstake"]

inProgress · boolean · required

Indicates whether there is an ongoing action for this position related to this request

Example:

true

blockchainPositionInfo · object · required

Additional fields per blockchain - can be empty or missing if not initialized or no additional info exists.

Option 1

Option 2

Option 3

Show child attributes

Example:

{
  "stakeAccountAddress": "3Ru67FyzMTcdENmmRL4Eve4dtPd6AdpuypR21q5EQCdq"
}

inProgressTxId · string

The transaction ID of the initial stake position request only. Only present when there is an active initial stake transaction.

Example:

"c80601f4-d7b1-4795-a8ee-b09cdb5b450c"

relatedRequests · object[]

Show child attributes

Example:

[
  {
    "status": "deactivating",
    "inProgress": false,
    "amount": "0.05",
    "txId": "c80601f4-d7b1-4795-a8ee-b09cdb5b450c"
  }
]