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.

post

Header parameters

apiKeystringRequired

The API key that was assigned to you by Native

Body

application/json

traderstringRequired

The address of the trader

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

recipientstringRequired

The address of the market maker or the settler

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

chainstring · enumRequired

Native blockchain name, eg: ethereum, bsc, etc

Example: ethereumPossible values:

Responses

201

Success

application/json

objectOptional

500

There was an exception with the server

post

/v1/lend/liquidation

HTTPcURLJavaScriptPython

POST /lend/v1/lend/liquidation HTTP/1.1
Host: newapi.native.org
apiKey: text
Content-Type: application/json
Accept: */*
Content-Length: 176

{
  "trader": "text",
  "recipient": "text",
  "chain": "ethereum",
  "positionUpdates": [
    {
      "tokenAddress": "text",
      "amount": "text"
    }
  ],
  "claimCollaterals": [
    {
      "tokenAddress": "text",
      "amount": "text"
    }
  ]
}

{}

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