Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities

api

markets

{marketId}

sync-oracle

curl -X POST "https://api.trusset.org/lending-external-securities/api/markets/{marketId}/sync-oracle" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"price": 105.40}'

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/markets/${marketId}/sync-oracle`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: 105.40 })
  }
);
const { success, data, error } = await res.json();
if (!success && error.code === 'PRICE_DEVIATION_TOO_LARGE') {
  // surface the deviation to an operator rather than retrying
}

{
  "success": true,
  "data": {
    "previousPrice": "104.820000",
    "newPrice": "105.4",
    "txHash": "0xabc...def"
  }
}

{
  "success": false,
  "error": {
    "code": "SIGNER_NOT_AUTHORIZED",
    "message": "Issuer wallet 0x123...456 is not authorized on oracle 0x8B2e...4a7c. The oracle owner must call setAuthorizedSigner."
  }
}

{
  "success": false,
  "error": {
    "code": "PRICE_DEVIATION_TOO_LARGE",
    "message": "Price deviation exceeds circuit breaker. On-chain: $104.820000, new: $250. Max allowed: 50%"
  }
}

{
  "success": false,
  "error": {
    "code": "MISSING_PRICE",
    "message": "A positive NAV price is required"
  }
}

Writes a new price to the market’s oracle through the registered wallet. This is how external securities markets are priced: the issuer publishes a net asset value and pushes it here. There is no automatic price feed for these markets. price is required on every call. If you omit it or send a non-positive value the request is rejected.

This submits a blockchain transaction. The registered wallet must be an authorized signer on the oracle, which the oracle owner grants. Check signerAuthorized on Get Oracle Status first.

Path Parameters

string

required

Market ID.

Body Parameters

number

required

Net asset value per collateral token, denominated in the market’s borrow asset. Must be greater than zero.

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

The on-chain price before this write.

string

The price written.

string

Transaction hash.

Circuit Breaker

The oracle rejects a price that deviates from the current price by more than maxDeviationBps, defaulting to 5000 basis points, which is 50 percent. This guards against a fat-fingered NAV wiping out healthy loans in one transaction. The check is skipped when the oracle has never been priced, so the first push after deployment can be any positive value. When the breaker trips, the error carries currentPrice, newPrice, and maxDeviationPercent so you can present the comparison. A genuine repricing beyond the limit requires the oracle owner to widen maxDeviationBps, or a sequence of smaller steps.

Successful pushes are recorded on the market as an ORACLE_SYNC transaction, visible through List Transactions, and update lastOracleUpdate on the market record.

curl -X POST "https://api.trusset.org/lending-external-securities/api/markets/{marketId}/sync-oracle" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"price": 105.40}'

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/markets/${marketId}/sync-oracle`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: 105.40 })
  }
);
const { success, data, error } = await res.json();
if (!success && error.code === 'PRICE_DEVIATION_TOO_LARGE') {
  // surface the deviation to an operator rather than retrying
}

{
  "success": true,
  "data": {
    "previousPrice": "104.820000",
    "newPrice": "105.4",
    "txHash": "0xabc...def"
  }
}

{
  "success": false,
  "error": {
    "code": "SIGNER_NOT_AUTHORIZED",
    "message": "Issuer wallet 0x123...456 is not authorized on oracle 0x8B2e...4a7c. The oracle owner must call setAuthorizedSigner."
  }
}

{
  "success": false,
  "error": {
    "code": "PRICE_DEVIATION_TOO_LARGE",
    "message": "Price deviation exceeds circuit breaker. On-chain: $104.820000, new: $250. Max allowed: 50%"
  }
}

{
  "success": false,
  "error": {
    "code": "MISSING_PRICE",
    "message": "A positive NAV price is required"
  }
}

Errors

Code	HTTP	Cause
`MISSING_PRICE`	`400`	`price` absent, non-numeric, or not greater than zero
`NO_ORACLE`	`400`	The market has no oracle recorded
`SIGNER_NOT_AUTHORIZED`	`403`	The registered wallet is not authorized on the oracle
`PRICE_DEVIATION_TOO_LARGE`	`400`	The change exceeds the oracle circuit breaker
`PREFLIGHT_FAILED`	`400`	The contract call reverted during simulation
`RELAYER_NOT_CONFIGURED`	`400`	No verified wallet is registered on this instance
`SYNC_FAILED`	`400`	The transaction failed on-chain. `message` carries the reason

Get Oracle Status

Sign Price

curl -X POST "https://api.trusset.org/lending-external-securities/api/markets/{marketId}/sync-oracle" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"price": 105.40}'

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/markets/${marketId}/sync-oracle`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: 105.40 })
  }
);
const { success, data, error } = await res.json();
if (!success && error.code === 'PRICE_DEVIATION_TOO_LARGE') {
  // surface the deviation to an operator rather than retrying
}

{
  "success": true,
  "data": {
    "previousPrice": "104.820000",
    "newPrice": "105.4",
    "txHash": "0xabc...def"
  }
}

{
  "success": false,
  "error": {
    "code": "SIGNER_NOT_AUTHORIZED",
    "message": "Issuer wallet 0x123...456 is not authorized on oracle 0x8B2e...4a7c. The oracle owner must call setAuthorizedSigner."
  }
}

{
  "success": false,
  "error": {
    "code": "PRICE_DEVIATION_TOO_LARGE",
    "message": "Price deviation exceeds circuit breaker. On-chain: $104.820000, new: $250. Max allowed: 50%"
  }
}

{
  "success": false,
  "error": {
    "code": "MISSING_PRICE",
    "message": "A positive NAV price is required"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Sync Oracle Price

Path Parameters

Body Parameters

Response Fields

Circuit Breaker

Errors

​Path Parameters

​Body Parameters

​Response Fields

​Circuit Breaker

​Errors

Path Parameters

Body Parameters

Response Fields

Circuit Breaker

Errors