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
post
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-24T17:29:02.563Z",
  "enableAt": "2025-06-24T17:29:02.563Z",
  "expiresAt": "2025-06-24T17:29:02.563Z",
  "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"
}

Last updated