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

# List curated Morpho markets

> List curated Morpho Blue lending markets for a chain.

Morpho Blue is permissionless, so credit actions identify a market by its
bytes32 market id. This returns the curated market set with live LLTV,
supply/borrow APY, utilization, and available liquidity -- read on-chain per
request -- so callers know which market_id to use and what it currently costs.



## OpenAPI

````yaml /v2/combined_spec.json get /v2/credit/morpho_markets
openapi: 3.1.0
info:
  title: Compass API
  description: Compass Labs DeFi API
  version: 0.0.1
servers:
  - url: https://api.compasslabs.ai
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /v2/credit/morpho_markets:
    get:
      tags:
        - Credit
      summary: List curated Morpho markets
      description: >-
        List curated Morpho Blue lending markets for a chain.


        Morpho Blue is permissionless, so credit actions identify a market by
        its

        bytes32 market id. This returns the curated market set with live LLTV,

        supply/borrow APY, utilization, and available liquidity -- read on-chain
        per

        request -- so callers know which market_id to use and what it currently
        costs.
      operationId: v2_credit_morpho_markets
      parameters:
        - name: chain
          in: query
          required: true
          schema:
            type: string
            enum:
              - arbitrum
              - base
              - bsc
              - ethereum
              - tempo
            title: Chain
            default: ethereum
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MorphoMarketsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-codeSamples:
        - lang: python
          label: Python (SDK)
          source: |-
            from compass_api_sdk import CompassAPI, models


            with CompassAPI(
                api_key_auth="<YOUR_API_KEY_HERE>",
            ) as compass_api:

                res = compass_api.credit.credit_morpho_markets(chain=models.V2CreditMorphoMarketsChain.ETHEREUM)

                # Handle response
                print(res)
        - lang: typescript
          label: Typescript (SDK)
          source: |-
            import { CompassApiSDK } from "@compass-labs/api-sdk";

            const compassApiSDK = new CompassApiSDK({
              apiKeyAuth: "<YOUR_API_KEY_HERE>",
            });

            async function run() {
              const result = await compassApiSDK.credit.creditMorphoMarkets({
                chain: "ethereum",
              });

              console.log(result);
            }

            run();
components:
  schemas:
    MorphoMarketsResponse:
      properties:
        morpho:
          type: string
          title: Morpho
          description: Morpho Blue singleton contract the markets were read from.
        markets:
          items:
            $ref: '#/components/schemas/MorphoLendingMarket'
          type: array
          title: Markets
          description: >-
            Curated lending markets with live LLTV, APYs, utilization, and
            liquidity.
          default: []
          example:
            - available_liquidity: '26607268.0000000000'
              borrow_apy: '4.4410000000'
              collateral_token: '0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf'
              collateral_token_decimals: 8
              collateral_token_symbol: cbBTC
              fee: '0.0000000000'
              irm: '0x870aC11D48B15DB9a138Cf899d20F13F79Ba00BC'
              lltv: '86.0000000000'
              loan_token: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
              loan_token_decimals: 6
              loan_token_symbol: USDC
              market_id: >-
                0x64d65c9a2d91c36d56fbc42d69e979335320169b3df63bf92789e2c8883fcc64
              oracle: '0xA6D6950c9F177F1De7f7757FB33539e3Ec60182a'
              supply_apy: '4.0110000000'
              total_borrow_assets: '247694465.0000000000'
              total_supply_assets: '274301733.0000000000'
              utilization: '90.3000000000'
      type: object
      required:
        - morpho
      title: MorphoMarketsResponse
      description: Curated Morpho Blue lending markets, read on-chain per request.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    MorphoLendingMarket:
      properties:
        market_id:
          type: string
          title: Market Id
          description: >-
            Morpho Blue market id — the bytes32 keccak of the market's
            (loanToken, collateralToken, oracle, irm, lltv) tuple. Pass this to
            the Morpho credit actions to identify the market.
        loan_token:
          type: string
          title: Loan Token
          description: Token that is supplied and borrowed in this market.
        loan_token_symbol:
          type: string
          title: Loan Token Symbol
          description: Symbol of the loan token (e.g. USDC).
        loan_token_decimals:
          type: integer
          title: Loan Token Decimals
          description: Decimals of the loan token.
        collateral_token:
          type: string
          title: Collateral Token
          description: Token accepted as collateral in this market.
        collateral_token_symbol:
          type: string
          title: Collateral Token Symbol
          description: Symbol of the collateral token (e.g. wstETH).
        collateral_token_decimals:
          type: integer
          title: Collateral Token Decimals
          description: Decimals of the collateral token.
        oracle:
          type: string
          title: Oracle
          description: Oracle pricing the collateral in loan-token terms for this market.
        irm:
          type: string
          title: Irm
          description: Interest rate model contract of this market.
        lltv:
          type: string
          title: Lltv
          description: >-
            Liquidation loan-to-value in percentage (e.g. 86 means a position is
            liquidatable once debt exceeds 86% of collateral value).
        supply_apy:
          anyOf:
            - type: string
            - type: 'null'
          title: Supply Apy
          description: >-
            Current supply APY for lending the loan token, in percentage (e.g.
            3.5 means 3.5%). Null if the rate is unavailable.
        borrow_apy:
          anyOf:
            - type: string
            - type: 'null'
          title: Borrow Apy
          description: >-
            Current borrow APY for the loan token, in percentage (e.g. 5.25
            means 5.25%). Null if the rate is unavailable.
        utilization:
          type: string
          title: Utilization
          description: Borrowed share of supplied assets, in percentage 0-100.
        total_supply_assets:
          type: string
          title: Total Supply Assets
          description: Total loan tokens supplied to the market, in token units.
        total_borrow_assets:
          type: string
          title: Total Borrow Assets
          description: Total loan tokens borrowed from the market, in token units.
        available_liquidity:
          type: string
          title: Available Liquidity
          description: >-
            Loan tokens available to borrow or withdraw (supplied - borrowed),
            in token units.
        fee:
          type: string
          title: Fee
          description: >-
            Protocol fee taken from interest, in percentage of interest (e.g. 0
            means no fee).
      additionalProperties: false
      type: object
      required:
        - market_id
        - loan_token
        - loan_token_symbol
        - loan_token_decimals
        - collateral_token
        - collateral_token_symbol
        - collateral_token_decimals
        - oracle
        - irm
        - lltv
        - utilization
        - total_supply_assets
        - total_borrow_assets
        - available_liquidity
        - fee
      title: MorphoLendingMarket
      description: 'A Morpho Blue lending market: one isolated (collateral, loan) pair.'
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Compass API Key. Get your key
        [here](https://www.compasslabs.ai/dashboard).

````