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

# Get collateral holders

> Fetches a list of users and total balances for one or more specified collateral mints.



## OpenAPI

````yaml post /markets/collateral/holders
openapi: 3.1.3
info:
  title: Loopscale API
  version: 1.0.0
servers:
  - url: https://tars.loopscale.com/v1
    description: Loopscale Production Server
security: []
paths:
  /markets/collateral/holders:
    post:
      summary: Get collateral holders
      description: >-
        Fetches a list of users and total balances for one or more specified
        collateral mints.
      operationId: getCollateralHolders
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CollateralHoldersRequest'
      responses:
        '200':
          $ref: '#/components/responses/CollateralHoldersResponse'
        '412':
          $ref: '#/components/responses/BadRequest'
        '500':
          $ref: '#/components/responses/GeneralError'
components:
  schemas:
    CollateralHoldersRequest:
      type: object
      properties:
        mints:
          type: array
          items:
            type: string
          description: List of collateral mint addresses to filter for.
        pdas:
          type: boolean
          description: >-
            Whether to return the PDAs holding the assets or the end borrower
            wallet.
      required:
        - mints
    CollateralHolder:
      type: object
      properties:
        collateralMint:
          type: string
        totalDeposits:
          type: number
        userDeposits:
          type: object
          properties:
            '[address]':
              type: number
          description: Deposits per user of corresponding collateral
  responses:
    CollateralHoldersResponse:
      description: A list of collateral holder objects
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/CollateralHolder'
          examples:
            example:
              value:
                - collateralMint: 6TiBRYFLs9H4wnwEVyqZfPs6bshAM9ZcaS976tDDGuD
                  totalDeposits: 389168.10806099995
                  userDeposits:
                    G7mjP2Hpj3A5d6f1LTjXUAy8MR8FDTvZcPY79RDhQv: 278911.414198
                    6Fjoe4udyj6r1ZLk3MDPcFzeDYNWvekSkjNwyEAsWTmTw: 137741.601249
    BadRequest:
      description: Bad Request
      content:
        text/plain:
          schema:
            type: string
            example: 'Something went wrong: You have an error in your SQL syntax.'
    GeneralError:
      description: General Server Error
      content:
        text/plain:
          schema:
            type: string
            example: >-
              Failed to deserialize the JSON body into the target type: missing
              field `mints` at line 1 column 1.

````