POST Liquidation

Whitelisted liquidator can request for Marker Maker liquidation by specifying what position they want to close and how much collateral they want to claim. Liquidator can do partial liquidation as long as the Market Maker credit health is increasing.

POSThttps://newapi.native.org/lend/v1/lend/liquidation

Header parameters

Body

application/json

trader*string

The address of the trader

Pattern: ^0x[a-fA-F0-9]{40}$

recipient*string

The address of the market maker or the settler

Pattern: ^0x[a-fA-F0-9]{40}$

chain*enum

Native blockchain name, eg: ethereum, bsc, etc

Example: "ethereum"

ethereumbscbsc_testnetsepoliapolygonmumbaiarbitrumavalanchemantlezetachain_athens3basemantascrollzetachainlineazklinkmorph_testnetmorph_holesky_testnetmantle_sepolia_testnetpolygon_amoy_testnetavalanche_fuji_testnetberachain_bartio_testnet

positionUpdates*array of TokenAmount (object)

The market maker position(s) that you want to close

claimCollaterals*array of TokenAmount (object)

How much collateral you want to claim from the market maker

Response

201500

Success

Body

application/json

LiquidationResponseDto (object)

Request

JavaScriptCurlPython

const response = await fetch('https://newapi.native.org/lend/v1/lend/liquidation', {
    method: 'POST',
    headers: {
      "apiKey": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "trader": "text",
      "recipient": "text",
      "chain": "ethereum",
      "positionUpdates": [
        {
          "tokenAddress": "text",
          "amount": "text"
        }
      ],
      "claimCollaterals": [
        {
          "tokenAddress": "text",
          "amount": "text"
        }
      ]
    }),
});
const data = await response.json();

Response

201

{}

During time delay

{
    "status": "pending",
    "readyAt": "2024-01-31T09:39:15.776Z",
    "expiresAt": "2024-01-31T09:40:15.776Z"
}

• Note that for position updates: A positive amount means you want to close short position by depositing money in, negative amount means you want to close long position by withdraw the money out.

• Claim collateral amount is always positive meaning how much collateral amount you want to claim