Sign in

v1

latestOpenAPI 3.0.02026-07-2442138225.7 KB
Positions
Positions

Get user liquidation history

Retrieve a paginated history of Morpho Blue liquidation events for a borrower address, read from the indexed store. This is the only place a fully-liquidated (closed) position can be retrieved, since it no longer appears in GET /v1/positions. Ordered by most recent first.

get/v1/positions/liquidations

Query parameters

offsetnumber

Offset for pagination

limitnumber
Example:25

Maximum number of items to return

integrationIdstring required
Example:morpho-blue-borrow

Integration identifier (must be a Morpho Blue borrow integration)

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
Example:ethereum

Network

addressstring required
Example:0x742d35Cc6634C0532925a3b844Bc9e7595f8fB28

User wallet address (the liquidated borrower)

marketIdstring
Example:morpho-blue-borrow-ethereum-cbbtc-usdc-0x0c6b...

Optional market filter. Accepts the integration market id or the on-chain bytes32 market hash.

Response

Paginated list of liquidation events

totalnumber required

Total number of items available

offsetnumber required

Offset of the current page

limitnumber required

Limit of the current page

Example response

{
  "total": 150,
  "limit": 100,
  "items": [
    {
      "id": "liq_0b3f...",
      "integrationId": "morpho-blue-borrow",
      "network": "ethereum",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fB28",
      "marketId": "morpho-blue-borrow-ethereum-cbbtc-usdc-0x0c6b...",
      "type": "partial",
      "occurredAt": "2026-05-21T14:08:12.000Z",
      "blockNumber": 22118447,
      "transactionHash": "0x8a3f...",
      "transactionLink": "https://etherscan.io/tx/0x8a3f...",
      "liquidator": "0x...",
      "repaidDebt": {
        "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "tokenSymbol": "USDC",
        "amount": "1500.000000",
        "amountRaw": "1500000000",
        "amountUsd": "1500.00",
        "shares": "1487123456789012345678"
      },
      "seizedCollateral": {
        "tokenAddress": "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
        "tokenSymbol": "cbBTC",
        "amount": "0.02356500",
        "amountRaw": "2356500",
        "amountUsd": "1567.34"
      },
      "badDebt": {
        "amountRaw": "0",
        "amount": "0",
        "amountUsd": "0.00",
        "shares": "0"
      },
      "lif": "1.0449"
    }
  ]
}