---
title: "Get a single market by ID"
method: GET
path: "/v1/markets/{marketId}"
tags: ["Markets", "Discovery"]
---

# Get a single market by ID

`GET /v1/markets/{marketId}`

Retrieve details for a specific lending market. Useful for deep linking into a specific market (e.g., cbBTC/USDT on Morpho Blue).

## Path parameters

- `marketId` string, required

## Response `200`

Market details

- MarketDto
  - `id` string, required — Market ID
  - `integrationId` string, required — Integration ID
  - `network` 'ethereum' | 'ethereum-goerli' | 'ethereum-holesky' | 'ethereum-sepolia' | 'ethereum-hoodi' | 'arbitrum' | 'base' | 'base-sepolia' | 'gnosis' | 'optimism' | 'polygon' | 'polygon-amoy' | 'starknet' | 'zksync' | 'linea' | 'unichain' | 'monad-testnet' | 'monad' | 'robinhood' | 'robinhood-testnet' | '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', required — Network
  - `type` 'pool' | 'isolated', required — Market type. "pool" for shared-pool protocols (Aave), "isolated" for pair-based protocols (Morpho Blue).
  - `poolAddress` string, required — Pool/protocol contract address
  - `loanToken` TokenDto, required
    - `address` string — Token contract address
    - `symbol` string, required — Token symbol
    - `name` string, required — Token name
    - `decimals` number, required — Token decimals
    - `logoURI` string — Token logo URI
  - `collateralTokens` CollateralTokenDto[], required — Accepted collateral tokens with per-collateral risk parameters. For isolated markets: single entry. For pool markets: all eligible collateral assets.
    - `token` TokenDto, required
      - `address` string — Token contract address
      - `symbol` string, required — Token symbol
      - `name` string, required — Token name
      - `decimals` number, required — Token decimals
      - `logoURI` string — Token logo URI
    - `priceUsd` string, required — Token price in USD
    - `maxLtv` string, required — Maximum loan-to-value ratio as decimal (e.g. "0.80" = 80% borrowing power)
    - `liquidationThreshold` string, required — Liquidation threshold as decimal
    - `liquidationPenalty` string, required — Liquidation penalty as decimal
    - `supplyRate` string, required — APY earned on this collateral while deposited (decimal, e.g. "0.02" = 2%)
  - `borrowRate` string, required — Current variable borrow rate as decimal
  - `totalSupply` string, required — Total supplied amount in human-readable token units
  - `totalSupplyRaw` string, required — Total supplied amount in raw token units
  - `totalBorrow` string, required — Total borrowed amount in human-readable token units
  - `totalBorrowRaw` string, required — Total borrowed amount in raw token units
  - `availableLiquidity` string, required — Available liquidity in human-readable token units
  - `availableLiquidityRaw` string, required — Available liquidity in raw token units
  - `utilizationRate` string, required — Utilization rate as decimal
  - `loanTokenPriceUsd` string, required — Loan token price in USD
  - `isBorrowEnabled` boolean, required — Whether borrowing is enabled for this asset
  - `supplyCollateralFeeBps` string, required — Deposit fee charged on supplyCollateral, in basis points (1 bp = 0.01%; 50 = 0.5%). Ranges from 0 to 500 (0% to 5%).
  - `feeWrapperAddress` string, nullable, required — 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.
  - `minLoan` string, nullable, required — 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).

## Other responses

- `401` — Invalid or missing API key
- `404` — Market not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/yield/apis/yield-xyz-api.md) · [All operations](https://skmtc.net/yield/apis/yield-xyz-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yield/yield-xyz-api/revisions/acfa80015ca5/schema)