List staking positions (Paginated)

get

https://api.fireblocks.io/v1/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: Admin, Non-Signing Admin, Signer, Approver, Editor.

Query Params

chainDescriptor

string

enum

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

vaultAccountId

string

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

pageSize

int32

required

1 to 100

Defaults to 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.

pageCursor

string

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

order

string

enum

Defaults to DESC

ASC / DESC ordering (default DESC)

Allowed:

Responses

Language

URL

Loading…

Response

Choose an example:

application/json

200Positions retrieved successfully with pagination.

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