Get 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.
This is a proxy to the Yield.xyz Borrow GET /v1/positions/liquidations endpoint. Portal validates the upstream response against the schema documented here before returning it under data, and translates network values to CAIP-2. If Yield.xyz changes the response shape, Portal returns a 500 with id: INTEGRATION_RESPONSE_SCHEMA_DRIFT instead of a partial response. Upstream reference: docs.yield.xyz.
Authorizations
Client API Key or Client Session Token (CST). Pass as a Bearer token in the Authorization header.
Query Parameters
Offset for pagination
x >= 00
Maximum number of items to return
1 <= x <= 10025
Integration identifier (must be a Morpho Blue borrow integration)
"morpho-blue-borrow"
Network identifier in CAIP-2 format (e.g. eip155:1 for Ethereum, eip155:8453 for Base). Portal translates this to the Yield.xyz network name; unsupported chains are rejected with a 400.
User wallet address (the liquidated borrower)
"0x742d35Cc6634C0532925a3b844Bc9e7595f8fB28"
Optional market filter. Accepts the integration market id or the on-chain bytes32 market hash.
"morpho-blue-borrow-ethereum-cbbtc-usdc-0x0c6b..."
Response
Paginated list of liquidation events