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

# List SVM detailed vaults

> Retrieves a filtered list of SVM vaults with detailed information including address (vault account public key), name, protocol, curator, TVL, and APY details. APY filter inputs and response values use v2 decimal semantics.



## OpenAPI

````yaml https://api.vaults.fyi/beta/documentation/json get /beta/svm/detailed-vaults
openapi: 3.0.3
info:
  title: Vaults.fyi Beta API
  version: 0.1.0
  description: >-
    Beta API endpoints for features in testing. These endpoints are not included
    in the main API documentation and may change without notice.
servers:
  - url: https://api.vaults.fyi
    description: Vaults.fyi Beta API
security: []
tags:
  - name: Borrow Markets
  - name: The Deep
  - name: Fixed Term (Pendle)
  - name: Portfolio
  - name: SVM
  - name: Advanced Analytics
paths:
  /beta/svm/detailed-vaults:
    get:
      tags:
        - SVM
      summary: List SVM detailed vaults
      description: >-
        Retrieves a filtered list of SVM vaults with detailed information
        including address (vault account public key), name, protocol, curator,
        TVL, and APY details. APY filter inputs and response values use v2
        decimal semantics.
      operationId: listSvmDetailedVaults
      parameters:
        - schema:
            type: integer
            minimum: 0
            default: 0
          in: query
          name: page
          required: false
          description: Page number (starting from 0)
        - schema:
            type: integer
            exclusiveMinimum: true
            minimum: 0
            maximum: 5000
            default: 50
          in: query
          name: perPage
          required: false
          description: Number of items per page
        - schema:
            type: string
            minLength: 1
          in: query
          name: assetSymbol
          required: false
          description: Include only vaults with an asset of provided symbol(ticker)
        - schema:
            type: array
            items:
              type: string
              minLength: 1
          in: query
          name: allowedAssets
          required: false
          description: Assets to be included by symbol(ticker).
        - schema:
            type: array
            items:
              type: string
              minLength: 1
          in: query
          name: disallowedAssets
          required: false
          description: >-
            Assets to be excluded by symbol(ticker). The parameter is ignored if
            "allowedAssets" is specified.
        - schema:
            type: array
            items:
              type: string
              minLength: 1
          in: query
          name: allowedProtocols
          required: false
          description: Protocols to be included by protocol ID or name.
        - schema:
            type: array
            items:
              type: string
              minLength: 1
          in: query
          name: disallowedProtocols
          required: false
          description: >-
            Protocols to be excluded by protocol ID or name. The parameter is
            ignored if "allowedProtocols" is specified.
        - schema:
            type: array
            items:
              type: string
              pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
          in: query
          name: allowedAssetMints
          required: false
          description: Asset SPL token mint account public keys to include.
        - schema:
            type: array
            items:
              type: string
              pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
          in: query
          name: disallowedAssetMints
          required: false
          description: >-
            Asset SPL token mint account public keys to exclude. The parameter
            is ignored if "allowedAssetMints" is specified.
        - schema:
            type: integer
            minimum: 0
            default: 100000
          in: query
          name: minTvl
          required: false
          description: Minimum TVL in USD of the vaults to be included
        - schema:
            type: integer
          in: query
          name: maxTvl
          required: false
          description: Maximum TVL in USD of the vaults to be included
        - schema:
            type: number
          in: query
          name: minApy
          required: false
          description: Minimum APY in v2 decimal units.
        - schema:
            type: number
          in: query
          name: maxApy
          required: false
          description: Maximum APY in v2 decimal units.
        - schema:
            type: string
            enum:
              - tvl
              - apy1day
              - apy7day
              - apy30day
          in: query
          name: sortBy
          required: false
          description: Field to sort by
        - schema:
            type: string
            enum:
              - asc
              - desc
            default: asc
          in: query
          name: sortOrder
          required: false
          description: Sort order, either asc or desc. Ascending is default.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  itemsOnPage:
                    type: integer
                    description: Number of items on the current page
                  nextPage:
                    type: integer
                    description: Next page number
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                          description: >-
                            Vault address. On SVM, this is the vault account
                            public key.
                        asset:
                          type: object
                          properties:
                            address:
                              type: string
                              description: >-
                                Asset address. On SVM, this is the SPL token
                                mint account public key.
                            name:
                              type: string
                              description: Name of the asset
                            symbol:
                              type: string
                              description: Symbol of the asset
                            decimals:
                              type: integer
                              description: Number of decimals of the asset
                            assetLogo:
                              type: string
                              format: uri
                              description: URL of the asset logo
                          required:
                            - address
                            - name
                            - symbol
                            - decimals
                          additionalProperties: false
                          description: Asset details of the vault
                        name:
                          type: string
                          description: Name of the vault
                        protocol:
                          type: object
                          properties:
                            protocolId:
                              type: string
                              description: >-
                                Lowercase protocol ID constructed from its name,
                                product, and version
                            name:
                              type: string
                              description: Name of the protocol
                            product:
                              type: string
                              description: Product of the protocol
                            version:
                              type: string
                              description: Version of the protocol
                            protocolLogo:
                              type: string
                              description: URL of the protocol logo
                          required:
                            - protocolId
                            - name
                          additionalProperties: false
                          description: Protocol details of the vault
                        tvl:
                          type: object
                          properties:
                            usd:
                              type: string
                              description: TVL in USD
                            native:
                              type: string
                              description: Native TVL
                          required:
                            - usd
                            - native
                          additionalProperties: false
                          description: TVL details of the vault
                        apy:
                          type: object
                          properties:
                            1day:
                              type: object
                              properties:
                                base:
                                  type: number
                                  description: Base APY
                                reward:
                                  type: number
                                  description: Reward APY
                                total:
                                  type: number
                                  description: Total APY
                              required:
                                - base
                                - reward
                                - total
                              additionalProperties: false
                              description: 1day APY details
                            7day:
                              type: object
                              properties:
                                base:
                                  type: number
                                  description: Base APY
                                reward:
                                  type: number
                                  description: Reward APY
                                total:
                                  type: number
                                  description: Total APY
                              required:
                                - base
                                - reward
                                - total
                              additionalProperties: false
                              description: 7day APY details
                            30day:
                              type: object
                              properties:
                                base:
                                  type: number
                                  description: Base APY
                                reward:
                                  type: number
                                  description: Reward APY
                                total:
                                  type: number
                                  description: Total APY
                              required:
                                - base
                                - reward
                                - total
                              additionalProperties: false
                              description: 30day APY details
                          required:
                            - 1day
                            - 7day
                            - 30day
                          additionalProperties: false
                          description: APY details of the vault
                        curator:
                          type: object
                          properties:
                            name:
                              type: string
                              description: Name of the curator
                            displayName:
                              type: string
                              description: Display name of the curator
                            description:
                              type: string
                              description: Description of the curator
                            websiteUrl:
                              type: string
                              description: Website URL of the curator
                          required:
                            - name
                          additionalProperties: false
                          description: Curator of the vault
                        lpToken:
                          type: object
                          properties:
                            address:
                              type: string
                              pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                              description: Address of the LP token mint account
                            tokenCaip:
                              type: string
                              pattern: >-
                                ^solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\/token:[1-9A-HJ-NP-Za-km-z]{32,44}$
                              description: >-
                                CAIP-19 identifier of the LP token on Solana
                                mainnet
                            name:
                              type: string
                            symbol:
                              type: string
                            decimals:
                              type: integer
                          required:
                            - address
                            - tokenCaip
                            - name
                            - symbol
                            - decimals
                          additionalProperties: false
                          description: LP token details of the vault
                      required:
                        - address
                        - asset
                        - name
                        - tvl
                        - apy
                      additionalProperties: false
                      description: Array of items on the current page
                required:
                  - itemsOnPage
                  - data
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      statusCode:
                        type: number
                      error:
                        type: string
                        enum:
                          - Bad Request
                      message:
                        type: string
                      errorId:
                        type: string
                    required:
                      - statusCode
                      - error
                      - message
                    additionalProperties: false
                  - {}
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      error:
                        type: string
                        enum:
                          - Unauthorized
                      message:
                        type: string
                        enum:
                          - >-
                            An API key is required to access this service. Sign
                            up at https://portal.vaults.fyi/signup to generate a
                            key. We offer a Pay-As-You-Go plan so you only pay
                            for what you use, with no commitments.
                      errorId:
                        type: string
                    required:
                      - error
                      - message
                    additionalProperties: false
                  - {}
        '402':
          description: Default Response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      x402Version:
                        anyOf:
                          - type: number
                          - type: string
                      error:
                        type: string
                      resource:
                        type: object
                        properties:
                          url:
                            type: string
                          description:
                            type: string
                          mimeType:
                            type: string
                          serviceName:
                            type: string
                          tags:
                            type: array
                            items:
                              type: string
                          iconUrl:
                            type: string
                        required:
                          - url
                        additionalProperties: false
                      accepts:
                        anyOf:
                          - type: array
                            items:
                              type: object
                              properties:
                                scheme:
                                  type: string
                                  enum:
                                    - exact
                                network:
                                  type: string
                                amount:
                                  type: string
                                payTo:
                                  type: string
                                maxTimeoutSeconds:
                                  type: number
                                asset:
                                  type: string
                                extra:
                                  type: object
                                  properties:
                                    name:
                                      type: string
                                    version:
                                      type: string
                                  required:
                                    - name
                                    - version
                                  additionalProperties: false
                              required:
                                - scheme
                                - network
                                - amount
                                - payTo
                                - maxTimeoutSeconds
                                - asset
                              additionalProperties: false
                          - {}
                      extensions:
                        type: object
                        additionalProperties: {}
                    required:
                      - x402Version
                      - resource
                    additionalProperties: false
                  - {}
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      error:
                        type: string
                        enum:
                          - Forbidden
                      message:
                        type: string
                        enum:
                          - >-
                            This API key has exhausted its available credits. To
                            resume service, please visit
                            https://portal.vaults.fyi/signup to top-up your
                            credits
                      errorId:
                        type: string
                    required:
                      - error
                      - message
                    additionalProperties: false
                  - {}
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - Not Found
                  message:
                    type: string
                required:
                  - error
                  - message
                additionalProperties: false
        '408':
          description: Default Response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      message:
                        type: string
                      errorId:
                        type: string
                    additionalProperties: false
                  - {}
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      statusCode:
                        type: number
                      error:
                        type: string
                        enum:
                          - Unprocessable Entity
                      message:
                        type: string
                      errorId:
                        type: string
                    required:
                      - statusCode
                      - error
                      - message
                    additionalProperties: false
                  - {}
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      error:
                        type: string
                        enum:
                          - Internal Server Error
                      message:
                        type: string
                      errorId:
                        type: string
                    required:
                      - error
                      - message
                    additionalProperties: false
                  - {}
        '503':
          description: Default Response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      statusCode:
                        type: number
                      error:
                        type: string
                        enum:
                          - Service Unavailable
                      message:
                        type: string
                      errorId:
                        type: string
                    required:
                      - statusCode
                      - error
                      - message
                    additionalProperties: false
                  - {}
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.