---
title: "Get chain-level staking parameters"
method: GET
path: "/staking/chains/{chainDescriptor}/chainInfo"
tags: ["Staking"]
---

# Get chain-level staking parameters

`GET /staking/chains/{chainDescriptor}/chainInfo`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/staking/chains/{chainDescriptor}/chainInfo`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/staking/chains/:chainDescriptor/chainInfo/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns chain-specific staking information such as epoch/slot cadence, lockup or unbonding periods, fee/reward mechanics, and other operational constraints.

## Path 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', required: Protocol identifier for the staking operation.

## Response `200`

Chain-specific staking information returned successfully.

- ChainInfoResponse
  - `chainDescriptor` string, required: The protocol identifier (e.g. "ETH"/"SOL").
  - `currentEpoch` number, required: The current epoch number of the blockchain network.
  - `epochElapsed` number, required: The percentage of time that has elapsed within the current epoch, represented as a decimal value between 0 and 1.
  - `epochDuration` number, required: The total duration in milliseconds of a single epoch.
  - `additionalInfo` AdditionalInfo, required: Additional information related to the blockchain. This may include extra details about the blockchain network.
    - `lockupPeriod` number, required: The duration of the lockup period for certain actions on the blockchain, measured in milliseconds.
    - `activationPeriod` number, required: The duration of the activation period for certain actions on the blockchain, measured in milliseconds.
  - `lastUpdated` number, required: timestamp (in milliseconds) of last update time

## Other responses

- `400`: Bad request: missing/invalid fields, unsupported amount, or malformed payload.
- `403`: Forbidden: insufficient permissions, disabled feature, or restricted provider/validator.
- `404`: Not found: requested resource does not exist (e.g., position, validator, provider, or wallet).
- `429`: Rate limit exceeded: slow down and retry later.
- `500`: Internal error while processing the request.
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)