Trusset Protocol - Infrastructure for Asset Tokenization

GET

lending-external-securities-v2

api

markets

{marketId}

fee-split

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/fee-split" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/fee-split`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const lp = data.legs.find((leg: { key: string }) => leg.key === 'LIQUIDITY_PROVIDERS');
console.log(`Liquidity providers keep ${lp.perHundred} percent of repaid interest`);

{
  "success": true,
  "data": {
    "readFailed": false,
    "marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
    "generation": "FIXED_SHARES",
    "fixedShares": true,
    "basis": "REPAID_INTEREST",
    "legs": [
      {
        "key": "INFRASTRUCTURE",
        "recipient": "0x65ff3a731366472d40cf458332457403168c2bea",
        "rateE18": "150000000000000000",
        "rateBps": 1500,
        "ofBase": "REPAID_INTEREST",
        "perHundred": "15",
        "effectiveBps": 1500
      },
      {
        "key": "OPERATOR",
        "recipient": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
        "rateE18": "80000000000000000",
        "rateBps": 800,
        "ofBase": "AFTER_INFRASTRUCTURE",
        "perHundred": "6.8",
        "effectiveBps": 680
      },
      {
        "key": "DISTRIBUTOR",
        "recipient": null,
        "rateE18": "50000000000000000",
        "rateBps": 500,
        "ofBase": "AFTER_INFRASTRUCTURE",
        "perHundred": "4.25",
        "effectiveBps": 425
      },
      {
        "key": "INSURANCE_FUND",
        "recipient": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
        "rateE18": "0",
        "rateBps": 0,
        "ofBase": "AFTER_SHARES",
        "perHundred": "0",
        "effectiveBps": 0
      },
      {
        "key": "LIQUIDITY_PROVIDERS",
        "recipient": null,
        "rateE18": null,
        "rateBps": null,
        "ofBase": "REMAINDER",
        "perHundred": "73.95",
        "effectiveBps": 7395
      }
    ],
    "operatorWallet": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
    "operatorWalletRecorded": true,
    "seekingCurator": false,
    "distributorRecipients": "VAULT_DISTRIBUTORS",
    "transactionFees": {
      "openFeeRaw": "0",
      "repayFeeRaw": "0",
      "openFee": "0.0",
      "repayFee": "0.0",
      "capBps": 50,
      "enabled": false,
      "shares": {
        "operatorBps": 800,
        "distributorBps": 500,
        "infrastructureBps": 8700
      }
    },
    "sources": {
      "infrastructure": "interest model getSupplyRate(1e18, 1e18, 0)",
      "operator": "factory OPERATOR_SHARE()",
      "distributor": "factory DISTRIBUTOR_SHARE()",
      "insuranceFund": "market config().protocolFeeRate"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "MARKET_STATE_UNAVAILABLE",
    "message": "The split of repaid interest could not be read from the market. Retry shortly."
  }
}

Returns how the market divides every unit of repaid interest, read from the contracts on each call rather than from stored configuration. Four named legs come off in a fixed order, and liquidity providers keep what is left. The order never changes. Trusset’s infrastructure fee takes 15 percent of repaid interest first. Of the remainder, the operator takes a fixed 8 percent and the distributors a fixed 5 percent. The market’s insurance-fund rate then takes its share of what is left, and the liquidity providers receive the rest. Each leg rounds down, so the liquidity providers absorb the rounding. Interest recovered through a liquidation is split the same way. Only one of these figures can move. The infrastructure rate is hardcoded, and the operator and distributor shares are constants on the factory that no party can set, raise, lower or redirect. The insurance-fund rate is the market’s protocolFeeRate, zero by default, which the issuer sets through Update Market Config. Nothing is paid out inline. Each leg is booked as a liability on the market and leaves through its own permissionless sweep. Get Cashflows shows what each leg has accrued, what has been swept and what is still pending.

Path Parameters

string

required

Market ID.

Response Fields

object

Show child attributes

string

Market contract, lowercased.

string

FIXED_SHARES on the current market implementation, where the operator and distributor shares are the factory constants. OFFERED_SHARE on a market still running the earlier implementation, where the operator share is what the market offered at deployment and there is no distributor leg.

boolean

true on FIXED_SHARES.

string

Always REPAID_INTEREST. Every effectiveBps and perHundred is a share of one unit of repaid interest.

array

Five entries in the order the market applies them: INFRASTRUCTURE, OPERATOR, DISTRIBUTOR, INSURANCE_FUND, LIQUIDITY_PROVIDERS.

Show child attributes

string

Which leg this is.

string

Where the leg is paid: the Trusset wallet fixed in the contract, the operator wallet, or the market’s insurance fund. null on DISTRIBUTOR, which is credited per provider (see distributorRecipients), and on LIQUIDITY_PROVIDERS, which stays in the pool.

string

The leg’s own rate against its base, at 18 decimals. null on LIQUIDITY_PROVIDERS.

integer

The same rate in basis points. null on LIQUIDITY_PROVIDERS.

string

What the rate applies to. REPAID_INTEREST for the infrastructure fee, AFTER_INFRASTRUCTURE for the operator and distributor shares, AFTER_SHARES for the insurance-fund rate, and REMAINDER for the liquidity providers.

integer

The leg’s share of repaid interest in basis points, rounded down. LIQUIDITY_PROVIDERS carries 10000 less the other four, so the five always sum to 10000.

string

The same share as a percentage at full precision, for example "6.8".

string

The wallet the operator share is paid to. On FIXED_SHARES this is the market’s operatorFeeRecipient, the wallet that took the lender-of-record role unless it has rotated itself since. On OFFERED_SHARE it is the lender of record the factory recorded. null while no lender of record has taken the market.

boolean

Whether the market records an operator wallet. null on OFFERED_SHARE.

boolean

true while the market is still seeking a lender of record, from the factory’s deployment record. null when that record could not be read.

string

VAULT_DISTRIBUTORS on FIXED_SHARES: the distributor leg is credited to liquidity providers in proportion to the liquidity each supplied. A registered vault passes its slice to the distributors behind its holders. NONE on OFFERED_SHARE.

object

The fixed open and repay fees stamped on the market at deployment. null on OFFERED_SHARE, or when they could not be read.

Show child attributes

string

Flat fee on every disbursement, in the borrow asset’s smallest unit.

string

Flat fee on every repayment, in the borrow asset’s smallest unit.

string

openFeeRaw as a decimal string. null when the borrow asset could not be read.

string

repayFeeRaw as a decimal string. null when the borrow asset could not be read.

integer

Always 50. Each charge is at most 0.5 percent of the amount borrowed or of the debt discharged.

boolean

true when either fee is above zero.

object

How each charge is shared: operatorBps, distributorBps and infrastructureBps. On the fixed shares that is 800, 500 and 8700.

object

Where each rate was read, for audit: infrastructure, operator, distributor and insuranceFund, each a short description of the contract call.

Read the split

rateBps and effectiveBps answer different questions. rateBps is the leg’s rate against its own base, which is what the contracts store. effectiveBps is what the leg takes out of repaid interest once the legs before it have come off. On a FIXED_SHARES market at the default insurance-fund rate of zero, 100 units of repaid interest split as follows.

Leg	`rateBps`	`ofBase`	`effectiveBps`	Of 100 units
`INFRASTRUCTURE`	`1500`	`REPAID_INTEREST`	`1500`	15
`OPERATOR`	`800`	`AFTER_INFRASTRUCTURE`	`680`	6.8
`DISTRIBUTOR`	`500`	`AFTER_INFRASTRUCTURE`	`425`	4.25
`INSURANCE_FUND`	`0`	`AFTER_SHARES`	`0`	0
`LIQUIDITY_PROVIDERS`	`null`	`REMAINDER`	`7395`	73.95

The fixed transaction fee is not part of this split. It is a flat charge on disbursement and repayment, shared 8 percent to the operator, 5 percent to the distributor leg and 87 percent to Trusset’s infrastructure liability. transactionFees.shares states those rates.

The split is cached for up to 60 seconds, so a change made on chain can take that long to appear here.

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/fee-split" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/fee-split`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const lp = data.legs.find((leg: { key: string }) => leg.key === 'LIQUIDITY_PROVIDERS');
console.log(`Liquidity providers keep ${lp.perHundred} percent of repaid interest`);

{
  "success": true,
  "data": {
    "readFailed": false,
    "marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
    "generation": "FIXED_SHARES",
    "fixedShares": true,
    "basis": "REPAID_INTEREST",
    "legs": [
      {
        "key": "INFRASTRUCTURE",
        "recipient": "0x65ff3a731366472d40cf458332457403168c2bea",
        "rateE18": "150000000000000000",
        "rateBps": 1500,
        "ofBase": "REPAID_INTEREST",
        "perHundred": "15",
        "effectiveBps": 1500
      },
      {
        "key": "OPERATOR",
        "recipient": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
        "rateE18": "80000000000000000",
        "rateBps": 800,
        "ofBase": "AFTER_INFRASTRUCTURE",
        "perHundred": "6.8",
        "effectiveBps": 680
      },
      {
        "key": "DISTRIBUTOR",
        "recipient": null,
        "rateE18": "50000000000000000",
        "rateBps": 500,
        "ofBase": "AFTER_INFRASTRUCTURE",
        "perHundred": "4.25",
        "effectiveBps": 425
      },
      {
        "key": "INSURANCE_FUND",
        "recipient": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
        "rateE18": "0",
        "rateBps": 0,
        "ofBase": "AFTER_SHARES",
        "perHundred": "0",
        "effectiveBps": 0
      },
      {
        "key": "LIQUIDITY_PROVIDERS",
        "recipient": null,
        "rateE18": null,
        "rateBps": null,
        "ofBase": "REMAINDER",
        "perHundred": "73.95",
        "effectiveBps": 7395
      }
    ],
    "operatorWallet": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
    "operatorWalletRecorded": true,
    "seekingCurator": false,
    "distributorRecipients": "VAULT_DISTRIBUTORS",
    "transactionFees": {
      "openFeeRaw": "0",
      "repayFeeRaw": "0",
      "openFee": "0.0",
      "repayFee": "0.0",
      "capBps": 50,
      "enabled": false,
      "shares": {
        "operatorBps": 800,
        "distributorBps": 500,
        "infrastructureBps": 8700
      }
    },
    "sources": {
      "infrastructure": "interest model getSupplyRate(1e18, 1e18, 0)",
      "operator": "factory OPERATOR_SHARE()",
      "distributor": "factory DISTRIBUTOR_SHARE()",
      "insuranceFund": "market config().protocolFeeRate"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "MARKET_STATE_UNAVAILABLE",
    "message": "The split of repaid interest could not be read from the market. Retry shortly."
  }
}

Error Codes

Code	HTTP	Cause
`MISSING_MARKET_ID`	`400`	The market ID in the path is longer than 100 characters
`NO_MARKET_ADDRESS`	`400`	The market has no on-chain address recorded
`MARKET_NOT_FOUND`	`404`	No market with this ID on your instance
`MARKET_STATE_UNAVAILABLE`	`503`	One of the rates could not be read from the chain, so no split is shown. Retry shortly

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/fee-split" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/fee-split`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const lp = data.legs.find((leg: { key: string }) => leg.key === 'LIQUIDITY_PROVIDERS');
console.log(`Liquidity providers keep ${lp.perHundred} percent of repaid interest`);

{
  "success": true,
  "data": {
    "readFailed": false,
    "marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
    "generation": "FIXED_SHARES",
    "fixedShares": true,
    "basis": "REPAID_INTEREST",
    "legs": [
      {
        "key": "INFRASTRUCTURE",
        "recipient": "0x65ff3a731366472d40cf458332457403168c2bea",
        "rateE18": "150000000000000000",
        "rateBps": 1500,
        "ofBase": "REPAID_INTEREST",
        "perHundred": "15",
        "effectiveBps": 1500
      },
      {
        "key": "OPERATOR",
        "recipient": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
        "rateE18": "80000000000000000",
        "rateBps": 800,
        "ofBase": "AFTER_INFRASTRUCTURE",
        "perHundred": "6.8",
        "effectiveBps": 680
      },
      {
        "key": "DISTRIBUTOR",
        "recipient": null,
        "rateE18": "50000000000000000",
        "rateBps": 500,
        "ofBase": "AFTER_INFRASTRUCTURE",
        "perHundred": "4.25",
        "effectiveBps": 425
      },
      {
        "key": "INSURANCE_FUND",
        "recipient": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
        "rateE18": "0",
        "rateBps": 0,
        "ofBase": "AFTER_SHARES",
        "perHundred": "0",
        "effectiveBps": 0
      },
      {
        "key": "LIQUIDITY_PROVIDERS",
        "recipient": null,
        "rateE18": null,
        "rateBps": null,
        "ofBase": "REMAINDER",
        "perHundred": "73.95",
        "effectiveBps": 7395
      }
    ],
    "operatorWallet": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
    "operatorWalletRecorded": true,
    "seekingCurator": false,
    "distributorRecipients": "VAULT_DISTRIBUTORS",
    "transactionFees": {
      "openFeeRaw": "0",
      "repayFeeRaw": "0",
      "openFee": "0.0",
      "repayFee": "0.0",
      "capBps": 50,
      "enabled": false,
      "shares": {
        "operatorBps": 800,
        "distributorBps": 500,
        "infrastructureBps": 8700
      }
    },
    "sources": {
      "infrastructure": "interest model getSupplyRate(1e18, 1e18, 0)",
      "operator": "factory OPERATOR_SHARE()",
      "distributor": "factory DISTRIBUTOR_SHARE()",
      "insuranceFund": "market config().protocolFeeRate"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "MARKET_STATE_UNAVAILABLE",
    "message": "The split of repaid interest could not be read from the market. Retry shortly."
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Get Fee Split

Path Parameters

Response Fields

Read the split

Error Codes

​Path Parameters

​Response Fields

​Read the split

​Error Codes

Path Parameters

Response Fields

Read the split

Error Codes