Sign in

v1

latestOpenAPI 3.0.02026-07-2442138225.7 KB
Markets
Discovery

Get a single market by ID

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

get/v1/markets/{marketId}

Path parameters

marketIdstring required
Example:aave-v3-ethereum-usdc

Market identifier (e.g., aave-v3-ethereum-usdc or Morpho Blue bytes32 key)

Response

Market details

idstring required

Market ID

integrationIdstring 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).

poolAddressstring required

Pool/protocol contract address

borrowRatestring required

Current variable borrow rate as decimal

totalSupplystring required

Total supplied amount in human-readable token units

totalSupplyRawstring required

Total supplied amount in raw token units

totalBorrowstring required

Total borrowed amount in human-readable token units

totalBorrowRawstring required

Total borrowed amount in raw token units

availableLiquiditystring required

Available liquidity in human-readable token units

availableLiquidityRawstring required

Available liquidity in raw token units

utilizationRatestring required

Utilization rate as decimal

loanTokenPriceUsdstring required

Loan token price in USD

isBorrowEnabledboolean required

Whether borrowing is enabled for this asset

supplyCollateralFeeBpsstring required

Deposit fee charged on supplyCollateral, in basis points (1 bp = 0.01%; 50 = 0.5%). Ranges from 0 to 500 (0% to 5%).

feeWrapperAddressstring 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.

minLoanstring 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).

Example response

{
  "id": "aave-v3-ethereum-usdc",
  "integrationId": "aave-borrow",
  "network": "ethereum",
  "type": "pool",
  "poolAddress": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
  "loanToken": {
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "symbol": "USDC",
    "name": "USD Coin",
    "decimals": 6
  },
  "collateralTokens": [
    {
      "token": {
        "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6
      },
      "priceUsd": "2800.00",
      "maxLtv": "0.80",
      "liquidationThreshold": "0.825",
      "liquidationPenalty": "0.05",
      "supplyRate": "0.02"
    }
  ],
  "borrowRate": "0.0567",
  "totalSupply": "1234567.89",
  "totalSupplyRaw": "1234567890000000",
  "totalBorrow": "987654.321",
  "totalBorrowRaw": "987654321000000",
  "availableLiquidity": "246913.569",
  "availableLiquidityRaw": "246913569000000",
  "utilizationRate": "0.80",
  "loanTokenPriceUsd": "1.00",
  "isBorrowEnabled": true,
  "supplyCollateralFeeBps": "50",
  "feeWrapperAddress": "0x29ac0c53Eb4b19295875D3895Fb1514ffC8e1616",
  "minLoan": "0.01"
}