Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities

api

positions

{marketId}

remove-liquidity

curl -X POST "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/remove-liquidity" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"shares": "50000"}'

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": {
      "to": "0x70a0e25c7b768b87e658348b3b577678a173e038",
      "data": "0x...",
      "value": "0",
      "chainId": 11155111
    },
    "functionName": "removeLiquidity"
  }
}

{
  "success": true,
  "data": {
    "txHash": "0x9f2c41d8b7e05a3164c2870fbd935e1a4c7802db6135ea9048f7c21b5d3ea41b",
    "sharesRedeemed": "50000.000000000000000000",
    "amount": "50082.576000"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_LIQUIDITY",
    "message": "The market has 12500.000000 USDC of uncommitted liquidity, which is less than this redemption is worth. Wait for borrowers to repay, or redeem fewer shares."
  }
}

Redeems LP shares for the borrow asset at the current share price, which includes accrued interest. No approval is needed, so this is a single transaction.

shares is always parsed at 18 decimals, regardless of the market’s borrow asset. This is the one amount in the API that does not follow the borrow asset’s precision. Read a provider’s share balance from Get Provider Balance and pass it through unchanged.

Path Parameters

string

required

Market ID.

Body Parameters

string

required

LP shares to redeem as a decimal string with up to 18 decimal places, for example "250000". Must be greater than zero.

string

Wallet holding the shares. When supplied, the redemption is checked against that provider’s share balance and against the pool’s uncommitted liquidity. A redemption that fails either check is refused with INSUFFICIENT_SHARES or INSUFFICIENT_LIQUIDITY, instead of handing back calldata that reverts. Omit it and only the market’s total share count is checked.

string

Hash of the transaction you broadcast for this operation. Send it to confirm the transaction and record the result. Omit it to receive the calldata.

Response Fields

object

Show child attributes

string

SIGN_TRANSACTION when txHash is omitted.

object

Unsigned transaction, { to, data, value, chainId }, for the removeLiquidity call. Returned when txHash is omitted.

string

removeLiquidity. Returned when txHash is omitted.

string

Transaction hash. Returned when confirming with txHash.

string

Shares actually burned, read from the LiquidityRemoved event, at 18 decimals. Returned when confirming with txHash.

string

Settlement amount that actually left the pool, in borrow asset units. Null when the event could not be read from the receipt. Returned when confirming with txHash.

Withdrawal is bounded by available liquidity, not by share balance. A provider holding shares worth more than the pool’s idle balance cannot exit fully while borrowers hold the difference, and the contract reverts rather than partially filling. Supply provider to have that refused before you sign, or check availableLiquidity on Get Market Metrics before redeeming a large position.

curl -X POST "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/remove-liquidity" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"shares": "50000"}'

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": {
      "to": "0x70a0e25c7b768b87e658348b3b577678a173e038",
      "data": "0x...",
      "value": "0",
      "chainId": 11155111
    },
    "functionName": "removeLiquidity"
  }
}

{
  "success": true,
  "data": {
    "txHash": "0x9f2c41d8b7e05a3164c2870fbd935e1a4c7802db6135ea9048f7c21b5d3ea41b",
    "sharesRedeemed": "50000.000000000000000000",
    "amount": "50082.576000"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_LIQUIDITY",
    "message": "The market has 12500.000000 USDC of uncommitted liquidity, which is less than this redemption is worth. Wait for borrowers to repay, or redeem fewer shares."
  }
}

Error Codes

Code	HTTP	Cause
`NO_MARKET_ADDRESS`	`400`	The market has no on-chain address recorded
`VALIDATION_ERROR`	`400`	`shares` is not a positive decimal string, or carries more than 18 decimal places
`INSUFFICIENT_SHARES`	`400`	`shares` exceeds the market’s outstanding shares, or the balance held by `provider`
`INSUFFICIENT_LIQUIDITY`	`400`	The redemption is worth more than the pool’s uncommitted liquidity. Only checked when `provider` is supplied
`MARKET_NOT_FOUND`	`404`	No market with this ID on your instance
`MARKET_STATE_UNAVAILABLE`	`503`	The market could not be read to check shares or liquidity. Retry shortly

curl -X POST "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/remove-liquidity" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"shares": "50000"}'

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": {
      "to": "0x70a0e25c7b768b87e658348b3b577678a173e038",
      "data": "0x...",
      "value": "0",
      "chainId": 11155111
    },
    "functionName": "removeLiquidity"
  }
}

{
  "success": true,
  "data": {
    "txHash": "0x9f2c41d8b7e05a3164c2870fbd935e1a4c7802db6135ea9048f7c21b5d3ea41b",
    "sharesRedeemed": "50000.000000000000000000",
    "amount": "50082.576000"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_LIQUIDITY",
    "message": "The market has 12500.000000 USDC of uncommitted liquidity, which is less than this redemption is worth. Wait for borrowers to repay, or redeem fewer shares."
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Remove Liquidity

Path Parameters

Body Parameters

Response Fields

Error Codes

​Path Parameters

​Body Parameters

​Response Fields

​Error Codes

Path Parameters

Body Parameters

Response Fields

Error Codes