---
title: "Get user staking pools"
method: GET
path: "/api/v1/users/{address}/nept/staking/pools"
tags: ["User"]
---

# Get user staking pools

`GET /api/v1/users/{address}/nept/staking/pools`

## Path parameters

- `address` string, required — The user account address

## 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` UserStakePool[], nullable, required — List contents
    - `common` StakingPoolFull, required — Merges `StakingPool` with both `StakingPoolWithParams` and `StakingPoolState`
      - `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
              - …
    - `amount_sum` string, required — Total staked of all entries **NOTE:** this value is affected by active filters, if any (e.g. filtering over account index)
    - `contents` UserStakeBondingEntry[], required — Bonding/stake entries **NOTE:** entries that differ only in amount are merged upon creation
      - `account_index` integer, required — User account index
      - `amount` string, required — Bonding amount
      - `cascade` boolean, required
      - `transition_at` string, date-time, nullable, required
      - `last_stake_acc` string, required
      - `extra` object, required
        - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`.
          - `amount` string, required
          - `transition_at` string, required
        - `value` object, nullable, required — USD values for the corresponding amounts above. Will not be null when query param `with_value` is `true`.
          - `amount` string, required
          - `extra` object, required
            - `text` object, nullable, required — Human-readable variants of USD values. Will not be null when query params `with_text` and `with_value` are `true`.
              - …
    - `extra` object, required
      - `text` object, nullable, required — Human-readable field variants. Will not be null when query param `with_text` is `true`.
        - `amount_sum` string, required
      - `value` object, nullable, required — USD values for the corresponding amounts above. Will not be null when query param `with_value` is `true`.
        - `amount_sum` string, required
        - `extra` object, required
          - `text` object, nullable, required — Human-readable variants of USD values. Will not be null when query params `with_text` and `with_value` are `true`.
            - `amount_sum` string, required
  - `count` integer, nullable, required — Total number of objects in all pages
  - `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` — 5 breaking, 35 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: 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/items/common/allOf[#/components/schemas/StakingPoolFull]/duration` response's property type changed from no type to `integer`, and format from no format to `uint64` for status `200`
  - the `error/anyOf[#/components/schemas/ErrorData]/kind/allOf[#/components/schemas/ErrorKind]/` response's property type changed from `string` to no type for status `200`
  - …36 more

[Change history](https://skmtc.dev/cryptechdev/apis/neptune-api-v2/changes/api/v1/users/:address/nept/staking/pools/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/8f59b54c563a/schema)