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

# Get all providers

> Returns a paginated list of all providers, including both protocol and validator providers.



## OpenAPI

````yaml get /v1/providers
openapi: 3.0.0
info:
  title: Yield.xyz API
  description: API Documentation
  version: '1.0'
  contact: {}
servers:
  - url: https://api.yield.xyz
    description: Production environment
  - url: https://api.staging.yield.xyz
    description: Staging environment
  - url: http://localhost:3000
    description: Local development
security: []
tags:
  - name: Discovery
    description: Browse and discover yield opportunities, networks, and providers
  - name: Portfolio
    description: User-specific balances, activity, and rewards
  - name: Actions
    description: Generate transactions to enter, exit, and manage yields
externalDocs:
  description: For more information
  url: https://docs.yield.xyz
paths:
  /v1/providers:
    get:
      tags:
        - Discovery
      summary: Get all providers
      description: >-
        Returns a paginated list of all providers, including both protocol and
        validator providers.
      operationId: ProvidersController_getProviders
      parameters:
        - name: offset
          required: false
          in: query
          description: Offset for pagination
          example: 0
          schema:
            minimum: 0
            default: 0
            type: number
        - name: limit
          required: false
          in: query
          description: Number of items per page
          example: 20
          schema:
            minimum: 1
            maximum: 100
            default: 20
            type: number
      responses:
        '200':
          description: List of providers
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PaginatedResponseDto'
                  - properties:
                      items:
                        type: array
                        items:
                          $ref: '#/components/schemas/ProviderDto'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Validation failed
                  error:
                    type: string
                    example: Bad Request
                  statusCode:
                    type: number
                    example: 400
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Invalid API key
                  error:
                    type: string
                    example: Unauthorized
                  statusCode:
                    type: number
                    example: 401
        '429':
          description: Rate limit exceeded
          headers:
            x-ratelimit-limit:
              description: Request limit per window
              schema:
                type: string
            x-ratelimit-remaining:
              description: Remaining requests (will be 0)
              schema:
                type: string
            x-ratelimit-reset:
              description: Unix timestamp when window resets
              schema:
                type: string
            retry-after:
              description: Seconds to wait before retrying
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Rate limit exceeded
                  error:
                    type: string
                    example: Too Many Requests
                  statusCode:
                    type: number
                    example: 429
                  retryAfter:
                    type: number
                    example: 30
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Internal server error
                  error:
                    type: string
                    example: Internal Server Error
                  statusCode:
                    type: number
                    example: 500
      security:
        - ApiKey: []
components:
  schemas:
    PaginatedResponseDto:
      type: object
      properties:
        total:
          type: number
          description: Total number of items available
          example: 100
        offset:
          type: number
          description: Offset of the current page
          example: 0
        limit:
          type: number
          description: Limit of the current page
          example: 20
      required:
        - total
        - offset
        - limit
    ProviderDto:
      type: object
      properties:
        name:
          type: string
          description: Provider name
          example: Morpho
        id:
          type: string
          description: Provider ID
          example: morpho
        logoURI:
          type: string
          description: Provider logo URI
          example: https://morpho.xyz/logo.png
        description:
          type: string
          description: Short description of the provider
          example: A peer-to-peer DeFi lending protocol
        website:
          type: string
          description: Provider website
          example: https://morpho.xyz
        tvlUsd:
          type: object
          description: Total TVL across the entire provider in USD
          example: 10,200,000
          nullable: true
        type:
          type: string
          description: Type of provider (protocol or validator provider)
          enum:
            - protocol
            - validator_provider
          example: protocol
        references:
          description: Optional social/media references or audit links
          nullable: true
          type: array
          items:
            type: string
      required:
        - name
        - id
        - logoURI
        - description
        - website
        - tvlUsd
        - type
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key

````