POST Verify collateral removal

Validates if the market maker's collateral removal request is valid.

post

Header parameters

apiKeystringRequired

The API key that was assigned to you by Native

Body

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:

traderstringRequired

The address of the trader

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

Responses

201

Success

application/json

500

There was an exception with the server

post

HTTPcURLJavaScriptPython

POST /lend/v1/lend/verify-collateral-removal HTTP/1.1
Host: newapi.native.org
apiKey: text
Content-Type: application/json
Accept: */*
Content-Length: 106

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

{
  "id": "text",
  "recipient": "text",
  "chain": {},
  "tokens": [
    "text"
  ],
  "totalCollateralRemovedUsd": 1,
  "trader": "text",
  "nonce": "text",
  "requestAt": "2025-06-04T03:32:06.301Z",
  "enableAt": "2025-06-04T03:32:06.301Z",
  "expiresAt": "2025-06-04T03:32:06.301Z",
  "type": "text"
}

Success response

{
    "id": "673a69b0-06db-4309-b0f1-6582435b80ca",
    "nonce": "6885024828728157",
    "recipient": "0x9B85B4A413Efe69684290816a3E814B4aA1EFf63",
    "chain": "base",
    "tokens": [
        {
            "tokenAddress": "0x5d55432c6aAeDB4D34523B2744e959F03aEffFE3",
            "amount": "10000000000000000000"
        }
    ],
    "totalCollateralRemovedUsd": 9.778953854000001e-12,
    "trader": "0x9B85B4A413Efe69684290816a3E814B4aA1EFf63",
    "requestAt": "2024-01-31T09:17:41.847Z",
    "enableAt": "2024-01-31T09:22:41.847Z",
    "expiresAt": "2024-01-31T09:23:41.847Z",
    "type": "collateralRemoval"
}

Error responses

// Invalid token
{
    "statusCode": 400,
    "message": "Collateral does not exist for token 0x12345",
    "error": "Bad Request"
}

// Insufficient collateral
{
    "statusCode": 400,
    "message": "Collateral amount is not enough for token 0x5d55432c6aAeDB4D34523B2744e959F03aEffFE3",
    "error": "Bad Request"
}

// Invalid mm
{
    "statusCode": 404,
    "message": "MM Settings not found",
    "error": "Not Found"
}