Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities-v2

api

markets

{marketId}

nominations

withdraw

curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/nominations/withdraw" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "candidate": "0xb27d0f6a91c458e307b2d4f8916ac05e73128b64" }'

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/nominations/withdraw`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ candidate: '0xb27d0f6a91c458e307b2d4f8916ac05e73128b64' })
  }
);
const { data } = await res.json();

const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": {
      "to": "0xf1ad12f5698f58badd8a662acffccb067a2ddb8a",
      "data": "0x...",
      "value": "0",
      "chainId": 11155111
    },
    "functionName": "withdrawNomination",
    "marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
    "candidate": "0xb27d0f6a91c458e307b2d4f8916ac05e73128b64",
    "signer": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_NOMINATED",
    "message": "This candidate is not currently nominated for this market"
  }
}

Returns the factory transaction that withdraws one candidate’s nomination. Once it mines, that wallet can no longer take the market as a nominee, and Get Nominations stops listing it. Withdrawing is only possible while the market still seeks a lender of record: after adoption the nomination list is fixed. A withdrawn wallet is not necessarily shut out. On a market deployed with openToAnyCurator, it can still claim the role the way any claimant nobody nominated can, when the deployer’s borrower register verifies it. Nominating it again restores its nomination. The same two checks apply as for Nominate Candidate. The API builds the transaction only when this instance’s registered wallet is the factory owner or on the factory’s deployer register. The factory accepts it only from the wallet that deployed this market, or from the factory owner. There is no confirm call.

Path Parameters

string

required

Market ID.

Body Parameters

string

required

Nominated wallet to withdraw. A checksum-valid address that is not the zero address. It must be nominated on this market right now.

Response Fields

object

Show child attributes

string

SIGN_TRANSACTION.

object

Unsigned transaction, { to, data, value, chainId }, addressed to the lending factory.

string

withdrawNomination.

string

Market contract address, lowercased.

string

The wallet whose nomination is withdrawn, lowercased.

string

This instance’s registered wallet, which the transaction expects to be signed by.

curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/nominations/withdraw" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "candidate": "0xb27d0f6a91c458e307b2d4f8916ac05e73128b64" }'

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/nominations/withdraw`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ candidate: '0xb27d0f6a91c458e307b2d4f8916ac05e73128b64' })
  }
);
const { data } = await res.json();

const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": {
      "to": "0xf1ad12f5698f58badd8a662acffccb067a2ddb8a",
      "data": "0x...",
      "value": "0",
      "chainId": 11155111
    },
    "functionName": "withdrawNomination",
    "marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
    "candidate": "0xb27d0f6a91c458e307b2d4f8916ac05e73128b64",
    "signer": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_NOMINATED",
    "message": "This candidate is not currently nominated for this market"
  }
}

Error Codes

Code	HTTP	Cause
`VALIDATION_ERROR`	`400`	`candidate` is missing, malformed, the zero address, or fails its EIP-55 checksum
`NO_MARKET_ADDRESS`	`400`	The market has no on-chain address
`WITHDRAW_NOMINATION_FAILED`	`400`	The transaction could not be built for a reason that carries no code of its own
`MISSING_MARKET_ID`	`400`	`marketId` is longer than 100 characters
`DEPLOYER_NOT_AUTHORIZED`	`403`	This instance’s registered wallet is neither the factory owner nor on the factory’s deployer register. A factory that could not be read for this check answers the same code
`MARKET_NOT_FOUND`	`404`	No market with this ID on your instance
`MARKET_NOT_DEPLOYED`	`404`	The lending factory holds no deployment for this market
`NOT_NOMINATED`	`409`	The candidate is not nominated on this market right now
`NOT_SEEKING_CURATOR`	`409`	The market already has a lender of record. The message names it
`WALLET_NOT_CONFIGURED`	`412`	This instance has no verified wallet to sign the withdrawal
`FACTORY_READ_FAILED`	`503`	The factory could not be reached to read the market. Retry shortly

curl -X POST "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/nominations/withdraw" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "candidate": "0xb27d0f6a91c458e307b2d4f8916ac05e73128b64" }'

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/nominations/withdraw`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ candidate: '0xb27d0f6a91c458e307b2d4f8916ac05e73128b64' })
  }
);
const { data } = await res.json();

const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTION",
    "transaction": {
      "to": "0xf1ad12f5698f58badd8a662acffccb067a2ddb8a",
      "data": "0x...",
      "value": "0",
      "chainId": 11155111
    },
    "functionName": "withdrawNomination",
    "marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
    "candidate": "0xb27d0f6a91c458e307b2d4f8916ac05e73128b64",
    "signer": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_NOMINATED",
    "message": "This candidate is not currently nominated for this market"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Withdraw Nomination

Path Parameters

Body Parameters

Response Fields

Error Codes

​Path Parameters

​Body Parameters

​Response Fields

​Error Codes

Path Parameters

Body Parameters

Response Fields

Error Codes