FIfireblocks
Staking

List staking positions (Paginated)

Returns staking positions with core details: amounts, rewards, status, chain, and vault. It supports cursor-based pagination for efficient data retrieval. This endpoint always returns a paginated response with {data, next} structure. Endpoint Permission: Owner, Admin, Non-Signing Admin, Signer, Approver, Editor, Viewer.

get/staking/positions_paginated

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

Filter positions by Fireblocks vault account ID. If omitted, positions across all vault accounts are returned.

pageSizeinteger required
Example:10

Number of results per page. When provided, the response returns a paginated object with {data, next}. If omitted, all results are returned as an array.

pageCursorstring
Example:eJ0eXAiOiJKV1QiLCJhbGcOiJIUzI1NiJ9

Cursor for the next page of results. Use the value from the 'next' field in the previous response.

order'ASC' | 'DESC'
Example:ASC

ASC / DESC ordering (default DESC)

Response

Positions retrieved successfully with pagination.

nextstring nullable

The cursor for the next page

Example response

{
  "data": [
    {
      "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",
      "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"
        }
      }
    }
  ],
  "next": "eJ0eXAiOiJKV1QiLCJhbGcOiJIUzI1NiJ9"
}

Changes

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