Get liquidations

Get user liquidation history

curl --request GET \
  --url https://borrow.yield.xyz/v1/positions/liquidations \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://borrow.yield.xyz/v1/positions/liquidations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://borrow.yield.xyz/v1/positions/liquidations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://borrow.yield.xyz/v1/positions/liquidations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://borrow.yield.xyz/v1/positions/liquidations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "total": 150,
  "offset": 0,
  "limit": 100,
  "items": [
    {
      "id": "liq_0b3f...",
      "integrationId": "morpho-blue-borrow",
      "network": "ethereum",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fB28",
      "marketId": "morpho-blue-borrow-ethereum-cbbtc-usdc-0x0c6b...",
      "type": "partial",
      "realizedBadDebt": false,
      "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"
    }
  ]
}

{
  "message": "Invalid API key",
  "error": "Unauthorized",
  "statusCode": 401
}

{
  "message": "Rate limit exceeded",
  "error": "Too Many Requests",
  "statusCode": 429,
  "retryAfter": 30
}

GET

positions

liquidations

Get user liquidation history

curl --request GET \
  --url https://borrow.yield.xyz/v1/positions/liquidations \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://borrow.yield.xyz/v1/positions/liquidations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://borrow.yield.xyz/v1/positions/liquidations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://borrow.yield.xyz/v1/positions/liquidations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://borrow.yield.xyz/v1/positions/liquidations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "total": 150,
  "offset": 0,
  "limit": 100,
  "items": [
    {
      "id": "liq_0b3f...",
      "integrationId": "morpho-blue-borrow",
      "network": "ethereum",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fB28",
      "marketId": "morpho-blue-borrow-ethereum-cbbtc-usdc-0x0c6b...",
      "type": "partial",
      "realizedBadDebt": false,
      "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"
    }
  ]
}

{
  "message": "Invalid API key",
  "error": "Unauthorized",
  "statusCode": 401
}

{
  "message": "Rate limit exceeded",
  "error": "Too Many Requests",
  "statusCode": 429,
  "retryAfter": 30
}

Available for morpho-blue-borrow only; any other integrationId returns 400. integrationId, network and address (the liquidated borrower) are required. marketId optionally narrows the history and accepts either a market id or the on-chain bytes32 market hash; anything else returns 400. offset defaults to 0; limit defaults to 25 and is at most 100. This is the only place a fully liquidated position can still be read. Fields are on Objects and enums.

Authorizations

x-api-key

string

header

required

Query Parameters

offset

number

default:0

Offset for pagination

Required range: x >= 0

Example:

0

limit

number

default:25

Maximum number of items to return

Required range: 1 <= x <= 100

Example:

25

integrationId

string

required

Integration identifier (must be a Morpho Blue borrow integration)

Example:

"morpho-blue-borrow"

network

enum<string>

required

Network

Available options:

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"

address

string

required

User wallet address (the liquidated borrower)

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f8fB28"

marketId

string

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

Example:

"morpho-blue-borrow-ethereum-cbbtc-usdc-0x0c6b..."

Response

Paginated list of liquidation events

total

number

required

Total number of items available

Example:

150

offset

number

required

Offset of the current page

Example:

0

limit

number

required

Limit of the current page

Example:

100

items

object[]

Show child attributes

Getting started

Earn

Trade

Borrow

Authorizations

Query Parameters

Response