--- title: "Get NEPT staking overview (incl. state + params)" method: GET path: "/api/v1/nept/staking" tags: ["NEPT"] --- # Get NEPT staking overview (incl. state + params) `GET /api/v1/nept/staking` ## Query parameters - `with_text` boolean — Include text variation fields - `with_value` boolean — Calculate and include USD values for amounts, where applicable ## Response `200` - object - `data` StakingOverview, required - `asset_info` AssetInfo, required — Asset identifiers with associated metadata - `asset` AssetSpec, required — Provides a unique identifier for an asset for use throughout the Neptune API. IDs are unique across asset domains (contract tokens, native denoms, etc) - `id` string, required - `group` union, required - 'native' - 'token' - `group_key` string, required - `metadata` AssetMetadata, required — Additional metadata for assets - `name` string, required — Full name of the asset - `symbol` string, required — Symbol of the asset, e.g.: `NEPT` `INJ` - `symbol_denom` string, required — Denom symbol for the asset (e.g. `inj` for `INJ`, `sat` for `BTC`) - `decimals_denom` integer, required — Denom exponent, or num. of decimal places that shift between denom/standard amounts (e.g. `18` for `INJ`) - `decimals_display` integer, required — Number of decimals used when displaying amounts of this asset (this is subjective and used for generating text representations) - `classification` union, required — The asset's classification metadata. Assets are classfied to provide context on their usage throughout the Neptune API (e.g. regular assets, neptune receipt tokens, LSTs, etc.) Each asset belongs to only a single classification type. This object contains metadata pertaining to the given classification. While some fields may be common among the distinct classifcations, each classification is distinct and subject to independent change. - object - `kind` 'regular', required - `neptune_receipt_asset` AssetSpec, required — Provides a unique identifier for an asset for use throughout the Neptune API. IDs are unique across asset domains (contract tokens, native denoms, etc) - `id` string, required - `group` union, required - … - `group_key` string, required - object - `kind` 'neptune_receipt_token', required - `origin_asset` AssetSpec, required — Provides a unique identifier for an asset for use throughout the Neptune API. IDs are unique across asset domains (contract tokens, native denoms, etc) - `id` string, required - `group` union, required - … - `group_key` string, required - object - `kind` 'liquid_staking_token', required - `origin_asset` AssetSpec, required — Provides a unique identifier for an asset for use throughout the Neptune API. IDs are unique across asset domains (contract tokens, native denoms, etc) - `id` string, required - `group` union, required - … - `group_key` string, required - `pools` StakingPoolFull[], required — Staking pool contract parameter. List of available staking pools - `index` integer, required — The ordered index (position) of this pool - `duration` integer, required — The lockup duration for this pool in seconds - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - `index` string, required - `duration` string, required - `params` StakingPoolParams, required - `reward_weight` string, required — The pool's weight (multiplier) on rewards for an associated stake - `gov_weight` string, required — The pool's weight (multiplier) on governance for an associated stake - `health_weight` string, required — The pool's weight (multiplier) on account health for an associated stake - `flash_loan_weight` string, required — The pool's weight (multiplier) for flash loans volume - `state` StakingPoolState, required - `total_bonded` string, required — The total amount staked to this pool - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - `total_bonded` string, required - `value` object, nullable, required — USD values for the corresponding amounts above. Will not be null when query param `with_value` is `true`. - `total_bonded` string, required - `extra` object, required - … - `global_state` StakingGlobalState, required — Staking state values that are not directly associated to a pool - `stake_acc` string, required — **TODO:** rename, proper description stake_acc = ∫ ( emission_rate / total_reward_weight ) dt - `rewards_last_distributed` string, date-time, required — When staking rewards were last distributed - `extra` object, required - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`. - `rewards_last_distributed` string, required - `error` ErrorData, required - `scope` union, required - 'user' - 'client' - 'server' - `kind` union, required - 'invalid_request' - 'validation' - 'entity_not_found' - 'contract' - 'internal' - `message` string, required — Error message - `fields` FieldValidationError[], nullable, required — List of names and error messages for invalid fields. Never NULL when `error.kind == 'validation'`. Always NULL for all other cases. - `field` string, required - `message` string, required - `status` integer, required — Request status - `status_text` string, required — Request status text ## Changes - **2026-03-01** `9048b9a34641` — 7 breaking, 28 info - added `subschema #1: Invalid request, subschema #2: Validation error, subschema #3: Requested entity not found, subschema #4: Contract error, subschema #5: Internal server error` to the `error/anyOf[#/components/schemas/ErrorData]/kind/allOf[#/components/schemas/ErrorKind]/` response property `oneOf` list for the response status `200` - added `subschema #1: Native token, subschema #2: CW20 token` to the `data/anyOf[#/components/schemas/StakingOverview]/asset_info/allOf[#/components/schemas/AssetInfo]/asset/allOf[#/components/schemas/AssetSpec]/group` response property `oneOf` list for the response status `200` - added `subschema #1: User error, subschema #2: Client error, subschema #3: Server error` to the `error/anyOf[#/components/schemas/ErrorData]/scope/allOf[#/components/schemas/ErrorScope]/` response property `oneOf` list for the response status `200` - the `data/anyOf[#/components/schemas/StakingOverview]/asset_info/allOf[#/components/schemas/AssetInfo]/asset/allOf[#/components/schemas/AssetSpec]/group` response's property type/format changed from `string`/`` to ``/`` for status `200` - …31 more [Change history](https://skmtc.dev/cryptechdev/apis/neptune-api-v2/changes/api/v1/nept/staking/get.md) --- [API](https://skmtc.dev/cryptechdev/apis/neptune-api-v2.md) · [All operations](https://skmtc.dev/cryptechdev/apis/neptune-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cryptechdev/neptune-api-v2/revisions/9048b9a34641/schema)