FIfireblocks
Staking

List staking positions

Returns all staking positions with core details: amounts, rewards, status, chain, and vault. Endpoint Permission: Owner, Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer.

get/staking/positions

Request

Query 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'

Protocol identifier for the staking operation.

Protocol identifier to filter positions (e.g., ATOM_COS/AXL/CELESTIA). If omitted, positions across all supported chains are returned.

vaultAccountIdstring numeric
Example:1

Filter positions by vault account ID.

Response

Positions retrieved successfully.

idstring required

The unique identifier of the staking position

vaultAccountIdstring required

The source vault account to stake from

validatorNamestring required

The destination validator address name

providerNamestring required

The destination validator provider name

chainDescriptorstring required

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

amountstring 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.

rewardsAmountstring nullable required

The amount staked in the position, measured in the staked asset unit. Returned as null for chains where reward tracking is not supported (Cosmos-family chains), instead of a numeric value.

dateCreatedstring date-time required

When was the request made (ISO Date).

dateUpdatedstring date-time required

When has the position last changed (ISO Date).

statusstring required

The current status.

validatorAddressstring required

The destination address of the staking transaction.

providerId'kiln' | 'figment' | 'lido' | 'p2p' | 'blockdaemon' | 'galaxy' | 'pierTwo' | 'kraken' required

The unique identifier of the staking provider

availableActionsstring[] required

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

inProgressboolean required

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

inProgressTxIdstring

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

Example response

[
  {
    "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,
    "inProgressTxId": "c80601f4-d7b1-4795-a8ee-b09cdb5b450c",
    "blockchainPositionInfo": {
      "stakeAccountAddress": "3Ru67FyzMTcdENmmRL4Eve4dtPd6AdpuypR21q5EQCdq",
      "rewardsBreakdown": {
        "inflation": "0.000856038",
        "mev": "0.000123456",
        "lastRewardSyncedAt": "2023-07-13T15:55:34.256Z"
      }
    },
    "relatedRequests": [
      {
        "status": "deactivating",
        "inProgress": false,
        "amount": "0.05",
        "txId": "c80601f4-d7b1-4795-a8ee-b09cdb5b450c"
      }
    ]
  }
]

Changes

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