> ## Documentation Index
> Fetch the complete documentation index at: https://docs.p2p.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get List Vaults

> Retrieve a list of vaults available for the current integration with metadata and performance metrics.



## OpenAPI

````yaml GET /api/v1/staking/pool/{network}/vaults
openapi: 3.0.0
info:
  title: Staking API
  description: API used for staking
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.p2p.org/api
security:
  - bearer: []
tags:
  - name: Aptos
    description: Aptos staking operations (stake, unstake, withdraw, claim).
  - name: Celestia
    description: Celestia staking operations (stake, unstake, redelegate, claim).
  - name: Cosmos
    description: Cosmos Hub staking operations (stake, unstake, redelegate, claim).
  - name: EigenLayer
    description: EigenLayer restaking operations.
  - name: Ethereum
    description: Ethereum staking operations (direct, SSV, pooled).
  - name: Hyperliquid
    description: Hyperliquid staking operations.
  - name: Monad
    description: Monad staking operations (delegate, undelegate, withdraw).
  - name: P2P SSV
    description: P2P-managed SSV validator operations (deposit, claim, withdraw).
  - name: Polkadot
    description: Polkadot staking and nomination pool operations.
  - name: Polygon
    description: Polygon staking operations.
  - name: Pooled Staking
    description: Pooled staking vault operations (deposit, unstake, withdraw).
  - name: Sei
    description: Sei staking operations (stake, unstake, redelegate, claim).
  - name: Solana
    description: Solana staking operations (stake, split, merge, deactivate, withdraw).
  - name: SSV
    description: SSV network validator operations.
  - name: Story
    description: Story network staking operations.
  - name: Sui
    description: Sui staking operations.
  - name: TON
    description: TON staking operations (single nominator, whales pool).
  - name: TRON
    description: TRON staking operations (freeze, delegate, vote, withdraw).
  - name: Unified
    description: Unified multi-chain staking interface.
paths:
  /api/v1/staking/pool/{network}/vaults:
    get:
      tags:
        - Pooled Staking
      summary: Get List Vaults
      description: >-
        Retrieve a list of vaults available for the current integration with
        metadata and performance metrics.
      operationId: eth-pool-staking-vaults-list
      parameters:
        - name: network
          required: true
          in: path
          description: >-
            <p>Ethereum pool network:</p><ul><li>`mainnet` — Ethereum
            mainnet.</li><li>`hoodi` — Ethereum testnet.</li></ul>
          schema:
            enum:
              - mainnet
              - hoodi
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SuccessResponse'
                  - type: object
                    properties:
                      result:
                        $ref: '#/components/schemas/StakingPoolVaultsListResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ExceptionResponse'
                  - type: object
                    properties:
                      error:
                        oneOf:
                          - $ref: >-
                              #/components/schemas/StakingPoolUnexpectedVaultsListException
                          - $ref: >-
                              #/components/schemas/StakingPoolNetworkIsNotIncludedInListException
              examples:
                UnexpectedVaultsListException:
                  value:
                    error:
                      code: 127115
                      message: >-
                        An unexpected error occurred while retrieving the list
                        of available vaults. Please try again later or contact
                        support.
                      name: UnexpectedVaultsListException
                      type: server
                    result: null
                StakingPoolNetworkIsNotIncludedInListException:
                  value:
                    error:
                      code: 127100
                      message: >-
                        Unsupported network specified. Please provide a network
                        from the allowed list: [ 'mainnet', 'hoodi' ].
                      name: StakingPoolNetworkIsNotIncludedInListException
                      type: client
                    result: null
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ExceptionResponse'
                  - type: object
                    properties:
                      error:
                        oneOf:
                          - $ref: '#/components/schemas/AuthNoTokenException'
                          - $ref: '#/components/schemas/AuthWrongTokenException'
              examples:
                NoTokenException:
                  value:
                    error:
                      code: 101111
                      message: >-
                        No Bearer token has been provided. To obtain an
                        authentication token, follow the instructions at
                        https://docs.p2p.org/docs/authentication.
                      name: NoTokenException
                      type: authentication
                    result: null
                WrongTokenException:
                  value:
                    error:
                      code: 101109
                      message: >-
                        An invalid Bearer token has been provided. Please
                        specify the correct authentication token.
                      name: WrongTokenException
                      type: authentication
                    result: null
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
        - bearer: []
components:
  schemas:
    SuccessResponse:
      type: object
      properties:
        error:
          type: object
          nullable: true
          default: null
          description: Error object. Always null on successful responses.
        result:
          type: object
          description: Response payload containing the requested data.
      description: Standard API success response envelope wrapping the result payload.
      required:
        - error
        - result
    StakingPoolVaultsListResponse:
      type: object
      properties:
        network:
          type: string
          enum:
            - mainnet
            - hoodi
          nullable: false
          example: hoodi
          description: 'Network name: `mainnet` or `hoodi`.'
        vaults:
          description: Array of vault objects matching the query criteria.
          type: array
          items:
            $ref: '#/components/schemas/StakingPoolVault'
      required:
        - network
        - vaults
    ExceptionResponse:
      type: object
      properties:
        error:
          type: object
          description: Error object containing exception details. Null on success.
        result:
          type: object
          nullable: true
          default: null
          description: Result payload. Always null on error responses.
        requestId:
          type: string
          description: >-
            Identifier of the request (the `x-request-id` header). Quote this
            value to correlate the response with server logs.
          example: 90c16e9e-6e99-4651-a033-60290356df2f
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp of when the error response was generated.
          example: '2026-05-20T22:29:03.126Z'
      description: Standard API error response envelope wrapping the exception details.
      required:
        - error
        - result
        - timestamp
    StakingPoolUnexpectedVaultsListException:
      type: object
      properties:
        type:
          type: string
          default: server
          example: server
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 127115
          example: 127115
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            An unexpected error occurred while retrieving the list of available
            vaults. Please try again later or contact support.
          example: >-
            An unexpected error occurred while retrieving the list of available
            vaults. Please try again later or contact support.
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: UnexpectedVaultsListException
          example: UnexpectedVaultsListException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - name
    StakingPoolNetworkIsNotIncludedInListException:
      type: object
      properties:
        type:
          type: string
          default: client
          example: client
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 127100
          example: 127100
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            Unsupported network specified. Please provide a network from the
            allowed list: [ 'mainnet', 'hoodi' ].
          example: >-
            Unsupported network specified. Please provide a network from the
            allowed list: [ 'mainnet', 'hoodi' ].
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: StakingPoolNetworkIsNotIncludedInListException
          example: StakingPoolNetworkIsNotIncludedInListException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - name
    AuthNoTokenException:
      type: object
      properties:
        type:
          type: string
          default: authentication
          example: authentication
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 101111
          example: 101111
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            No Bearer token has been provided. To obtain an authentication
            token, follow the instructions at
            https://docs.p2p.org/docs/authentication.
          example: >-
            No Bearer token has been provided. To obtain an authentication
            token, follow the instructions at
            https://docs.p2p.org/docs/authentication.
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: NoTokenException
          example: NoTokenException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - name
    AuthWrongTokenException:
      type: object
      properties:
        type:
          type: string
          default: authentication
          example: authentication
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 101109
          example: 101109
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            An invalid Bearer token has been provided. Please specify the
            correct authentication token.
          example: >-
            An invalid Bearer token has been provided. Please specify the
            correct authentication token.
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: WrongTokenException
          example: WrongTokenException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - name
    StakingPoolVault:
      type: object
      properties:
        vaultAddress:
          type: string
          description: Ethereum address of the vault's smart contract.
          nullable: false
          pattern: ^0x[a-fA-F0-9]{40}$
          example: '0x4Dd92880f7EF2270b2B7dd67e1DfC27D752311d3'
        displayName:
          type: string
          description: Vault name.
        apy:
          type: number
          format: double
          description: >-
            Current annual percentage yield (APY) of the vault including extra
            incentives.
        baseApy:
          type: number
          format: double
          description: Average weekly base APY of the vault without extra incentives.
        capacity:
          type: number
          format: double
          description: Maximum total value locked (TVL) of the vault.
          nullable: false
          example: 1234.56789
        totalAssets:
          type: number
          format: double
          description: Current amount of assets staked in the vault.
          nullable: false
          example: 1234.56789
        feePercent:
          type: number
          format: double
          description: Amount of fee in percents charged by the vault.
        isPrivate:
          type: boolean
          description: >-
            <p>Parameter indicating if this vault is exclusive to current
            integration:</p><ul><li>`true` — vault is private.</li><li>`false` —
            vault is public or shared.</li></ul>
        isGenesis:
          type: boolean
          description: Parameter indicating if this vault is a Genesis StakeWise vault.
        isSmoothingPool:
          type: boolean
          description: >-
            Parameter indicating if this vault is a Smoothing Pool or a Vault
            Escrow.
        isErc20:
          type: boolean
          description: Parameter indicating if this vault has its own ERC-20 token.
        tokenName:
          type: object
          description: >-
            Name of the ERC-20 token that represents ETH staked by delegators in
            the vault.
        tokenSymbol:
          type: object
          description: Symbol of the vault's ERC-20 token.
        createdAt:
          type: string
          format: date-time
          description: Timestamp of the vault creation in the ISO 8601 format.
          nullable: false
          example: '2025-07-12T12:34:56.789Z'
      required:
        - vaultAddress
        - displayName
        - apy
        - baseApy
        - capacity
        - totalAssets
        - feePercent
        - isPrivate
        - isGenesis
        - isSmoothingPool
        - isErc20
        - createdAt
  responses:
    TooManyRequests:
      description: >-
        Too Many Requests — the client exceeded its rate limit. The response
        advertises when to retry and the active quota via headers.
      headers:
        Retry-After:
          description: Number of seconds to wait before retrying the request.
          schema:
            type: integer
            example: 60
        RateLimit-Limit:
          description: >-
            The request quota (maximum number of requests) for the most
            restrictive applicable window.
          schema:
            type: integer
            example: 120
        RateLimit-Reset:
          description: >-
            Number of seconds until the rate-limit window resets and requests
            are accepted again.
          schema:
            type: integer
            example: 60
        RateLimit-Policy:
          description: >-
            The active rate-limit policy as `<limit>;w=<window-seconds>`,
            comma-separated when multiple windows apply.
          schema:
            type: string
            example: 120;w=60
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: integer
                  name:
                    type: string
                    example: ThrottlerException
                  message:
                    type: string
                    example: ThrottlerException
                  errors:
                    type: array
                    nullable: true
                    items:
                      type: object
              result:
                type: object
                nullable: true
                example: null
              requestId:
                type: string
                description: >-
                  Identifier of the request (the `x-request-id` header). Quote
                  this value to correlate the response with server logs.
                example: 90c16e9e-6e99-4651-a033-60290356df2f
              timestamp:
                type: string
                format: date-time
                description: ISO 8601 timestamp of when the error response was generated.
                example: '2026-05-20T22:29:03.126Z'
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

## Related topics

- [Get Operator List](/reference/eth-eigen-operator-list.md)
- [Get List Validators](/reference/p2p-transaction-direct-validator.md)
- [Get List Delegations](/reference/monad-delegators-get-delegations.md)
- [Get List Stakes](/reference/sui-transaction-get-stake-list.md)
