> ## 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 a market

> Return one lending market by id, including collateral parameters, rates and liquidity.

Looks the market up by id without applying `scope`, so it also returns markets that are not enabled for your project. Fee fields in the response are resolved for your project. An unknown id returns `404`.

Fields are described on [Objects and enums](/api-reference/borrow/objects#market-models).


## OpenAPI

````yaml openapi-borrow.json GET /v1/markets/{marketId}
openapi: 3.0.0
info:
  title: 'Yield API: Borrow'
  description: API Documentation
  version: '1.0'
  contact: {}
servers:
  - url: https://borrow.yield.xyz
    description: Production
security: []
tags:
  - name: Discovery
    description: Browse and discover lending markets, integrations, and supported networks
  - name: Positions
    description: User-specific supply and borrow positions
  - name: Actions
    description: >-
      Execute actions (supply, borrow, repay, withdraw) and manage multi-step
      flows
  - name: Transactions
    description: Submit signed transactions and track status
externalDocs:
  description: For more information
  url: https://docs.yield.xyz
paths:
  /v1/markets/{marketId}:
    get:
      tags:
        - Markets
        - Discovery
      summary: Get a single market by ID
      description: >-
        Retrieve details for a specific lending market. Useful for deep linking
        into a specific market (e.g., cbBTC/USDT on Morpho Blue).
      operationId: MarketsController_getMarketById_v1
      parameters:
        - name: marketId
          required: true
          in: path
          description: >-
            Market identifier (e.g., aave-v3-ethereum-usdc or Morpho Blue
            bytes32 key)
          schema:
            example: aave-v3-ethereum-usdc
            type: string
      responses:
        '200':
          description: Market details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketDto'
        '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
        '404':
          description: Market not found
        '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
      security:
        - ApiKey: []
components:
  schemas:
    MarketDto:
      type: object
      properties:
        id:
          type: string
          description: Market ID
          example: aave-v3-ethereum-usdc
        integrationId:
          type: string
          description: Integration ID
          example: aave-borrow
        network:
          type: string
          description: Network
          enum:
            - ethereum
            - ethereum-goerli
            - ethereum-holesky
            - ethereum-sepolia
            - ethereum-hoodi
            - arbitrum
            - base
            - base-sepolia
            - gnosis
            - optimism
            - polygon
            - polygon-amoy
            - starknet
            - zksync
            - linea
            - unichain
            - plume
            - monad-testnet
            - monad
            - robinhood
            - robinhood-testnet
            - arc-testnet
            - arc
            - avalanche-c
            - avalanche-c-atomic
            - avalanche-p
            - binance
            - celo
            - fantom
            - harmony
            - moonriver
            - okc
            - viction
            - core
            - sonic
            - plasma
            - katana
            - hyperevm
            - tempo
            - pharos
            - agoric
            - akash
            - axelar
            - band-protocol
            - bitsong
            - canto
            - chihuahua
            - comdex
            - coreum
            - cosmos
            - crescent
            - cronos
            - cudos
            - desmos
            - dydx
            - evmos
            - fetch-ai
            - gravity-bridge
            - injective
            - irisnet
            - juno
            - kava
            - ki-network
            - mars-protocol
            - nym
            - okex-chain
            - onomy
            - osmosis
            - persistence
            - quicksilver
            - regen
            - secret
            - sentinel
            - sommelier
            - stafi
            - stargaze
            - stride
            - teritori
            - tgrade
            - umee
            - sei
            - mantra
            - celestia
            - saga
            - zetachain
            - dymension
            - humansai
            - neutron
            - polkadot
            - kusama
            - westend
            - bittensor
            - aptos
            - binancebeacon
            - cardano
            - near
            - solana
            - solana-devnet
            - stellar
            - stellar-testnet
            - sui
            - tezos
            - tron
            - ton
            - ton-testnet
            - hyperliquid
          example: ethereum
        type:
          type: string
          description: >-
            Market type. "pool" for shared-pool protocols (Aave), "isolated" for
            pair-based protocols (Morpho Blue).
          example: pool
          enum:
            - pool
            - isolated
        poolAddress:
          type: string
          description: Pool/protocol contract address
          example: '0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2'
        loanToken:
          description: The borrowable token
          allOf:
            - $ref: '#/components/schemas/TokenDto'
        collateralTokens:
          description: >-
            Accepted collateral tokens with per-collateral risk parameters. For
            isolated markets: single entry. For pool markets: all eligible
            collateral assets.
          type: array
          items:
            $ref: '#/components/schemas/CollateralTokenDto'
        borrowRate:
          type: string
          description: Current variable borrow rate as decimal
          example: '0.0567'
        totalSupply:
          type: string
          description: Total supplied amount in human-readable token units
          example: '1234567.89'
        totalSupplyRaw:
          type: string
          description: Total supplied amount in raw token units
          example: '1234567890000000'
        totalBorrow:
          type: string
          description: Total borrowed amount in human-readable token units
          example: '987654.321'
        totalBorrowRaw:
          type: string
          description: Total borrowed amount in raw token units
          example: '987654321000000'
        availableLiquidity:
          type: string
          description: Available liquidity in human-readable token units
          example: '246913.569'
        availableLiquidityRaw:
          type: string
          description: Available liquidity in raw token units
          example: '246913569000000'
        utilizationRate:
          type: string
          description: Utilization rate as decimal
          example: '0.80'
        loanTokenPriceUsd:
          type: string
          description: Loan token price in USD
          example: '1.00'
        isBorrowEnabled:
          type: boolean
          description: Whether borrowing is enabled for this asset
          example: true
        supplyCollateralFeeBps:
          type: string
          description: >-
            Deposit fee charged on supplyCollateral, in basis points (1 bp =
            0.01%; 50 = 0.5%). Ranges from 0 to 500 (0% to 5%).
          example: '50'
          minimum: 0
          maximum: 500
        feeWrapperAddress:
          type: string
          description: >-
            Address of the fee wrapper contract charging the deposit fee for the
            requesting project. null when no wrapper is configured for the
            (project, integration) pair.
          example: '0x29ac0c53Eb4b19295875D3895Fb1514ffC8e1616'
          nullable: true
        originationFeeBps:
          type: string
          description: >-
            Origination fee for plain borrow (allocator wrapper default), in
            basis points (1 bp = 0.01%). When no wrapper is set, mirrors
            blueBundleOriginationFeeBps if BlueBundle is configured, else "0".
          example: '100'
        originationFeeWrapperAddress:
          type: string
          description: >-
            Address of the wrapper contract charging the origination fee for the
            requesting project. null when no origination wrapper is configured.
          example: '0x3C778911B9e36eA8CE53dBF211a203e3300939b6'
          nullable: true
        blueBundleOriginationFeeBps:
          type: string
          description: >-
            BlueBundle origination fee for supplyAndBorrow, in basis points.
            null when not configured.
          example: '50'
          nullable: true
        minLoan:
          type: string
          description: >-
            Minimum borrowable amount in human-readable loan-token units.
            Borrows that would leave debt below this floor, and partial repays
            that leave remaining debt below it, revert on-chain. null when the
            market enforces no minimum (e.g. non-Lista integrations).
          example: '0.01'
          nullable: true
      required:
        - id
        - integrationId
        - network
        - type
        - poolAddress
        - loanToken
        - collateralTokens
        - borrowRate
        - totalSupply
        - totalSupplyRaw
        - totalBorrow
        - totalBorrowRaw
        - availableLiquidity
        - availableLiquidityRaw
        - utilizationRate
        - loanTokenPriceUsd
        - isBorrowEnabled
        - supplyCollateralFeeBps
        - feeWrapperAddress
        - originationFeeBps
        - originationFeeWrapperAddress
        - blueBundleOriginationFeeBps
        - minLoan
    TokenDto:
      type: object
      properties:
        address:
          type: string
          description: Token contract address
          example: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
        symbol:
          type: string
          description: Token symbol
          example: USDC
        name:
          type: string
          description: Token name
          example: USD Coin
        decimals:
          type: number
          description: Token decimals
          example: 6
        logoURI:
          type: string
          description: Token logo URI
      required:
        - symbol
        - name
        - decimals
    CollateralTokenDto:
      type: object
      properties:
        token:
          description: Collateral token details
          allOf:
            - $ref: '#/components/schemas/TokenDto'
        priceUsd:
          type: string
          description: Token price in USD
          example: '2800.00'
        maxLtv:
          type: string
          description: >-
            Maximum loan-to-value ratio as decimal (e.g. "0.80" = 80% borrowing
            power)
          example: '0.80'
        liquidationThreshold:
          type: string
          description: Liquidation threshold as decimal
          example: '0.825'
        liquidationPenalty:
          type: string
          description: Liquidation penalty as decimal
          example: '0.05'
        supplyRate:
          type: string
          description: >-
            APY earned on this collateral while deposited (decimal, e.g. "0.02"
            = 2%)
          example: '0.02'
      required:
        - token
        - priceUsd
        - maxLtv
        - liquidationThreshold
        - liquidationPenalty
        - supplyRate
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key

````

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