Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities

api

markets

{marketId}

sign-price

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

const signRes = await fetch(
  `https://api.trusset.org/lending-external-securities/api/markets/${marketId}/sign-price`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: 105.40, validitySeconds: 300 })
  }
);
const { data: signed } = await signRes.json();

const { domain, types, message } = signed.typedData;
const signature = await wallet._signTypedData(domain, types, message);

const loanRes = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/open-loan`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      collateralAmount: '1000',
      borrowAmount: '50000',
      signedPrice: {
        price: signed.price,
        timestamp: signed.timestamp,
        validUntil: signed.validUntil,
        signature
      }
    })
  }
);

{
  "success": true,
  "data": {
    "action": "SIGN_TYPED_DATA",
    "typedData": {
      "domain": {
        "name": "SecurityPriceOracle",
        "version": "1",
        "chainId": 11155111,
        "verifyingContract": "0x8B2e...4a7c"
      },
      "types": {
        "PriceUpdate": [
          { "name": "price", "type": "uint256" },
          { "name": "timestamp", "type": "uint256" },
          { "name": "validUntil", "type": "uint256" }
        ]
      },
      "primaryType": "PriceUpdate",
      "message": {
        "price": "105400000",
        "timestamp": 1718445600,
        "validUntil": 1718445900
      }
    },
    "display": {
      "price": "105400000",
      "priceUsd": "105.4",
      "timestamp": 1718445600,
      "validUntil": 1718445900,
      "signer": "0x123...456"
    },
    "price": "105400000",
    "priceUsd": "105.4",
    "timestamp": 1718445600,
    "validUntil": 1718445900,
    "signer": "0x123...456"
  }
}

{
  "success": false,
  "error": {
    "code": "SIGNING_FAILED",
    "message": "Issuer wallet 0x123...456 not authorized on oracle. Authorize it via setAuthorizedSigner first."
  }
}

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

Returns an EIP-712 payload for a NAV, ready to sign. You sign it with the wallet authorized on the market’s oracle, then pass the price and your signature as signedPrice on Open Loan, Borrow More, Withdraw Collateral, or Liquidate Loan. The contract applies the price and the action in one transaction. This is the alternative to Sync Oracle Price. Signing costs no gas and writes nothing on-chain, so it suits per-transaction pricing where a borrower needs a fresh valuation without waiting for an oracle write. Pushing suits a scheduled NAV publication that every loan in the market should see.

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.

integer

default:"300"

Signature lifetime in seconds. Values below 60 are raised to 60 and values above 3600 are lowered to 3600.

Response Fields

object

Show child attributes

string

Always SIGN_TYPED_DATA.

object

The EIP-712 payload to sign, carrying domain, types, primaryType, and message. Pass it straight to signTypedData.

object

The same values in readable form, also flattened onto data itself.

string

Price in base units at the borrow asset’s decimals. Pass this value, not priceUsd, in the signedPrice object.

string

The same price as a human-readable decimal string. Informational.

integer

Unix seconds the price is stamped at. Never ahead of chain time.

integer

Unix seconds after which the signature is rejected.

string

The wallet expected to sign. Signing with any other wallet produces a signature the oracle rejects.

No signature is returned. You produce it by signing typedData. The contract then reads price, timestamp, validUntil, and your signature. Pass the first three through unchanged.

Signature Structure

domain = {
  name: "SecurityPriceOracle",
  version: "1",
  chainId: <chain the market is deployed on>,
  verifyingContract: <market oracle address>
}

PriceUpdate = {
  price:      uint256
  timestamp:  uint256
  validUntil: uint256
}

The signature is bound to one oracle through verifyingContract and expires at validUntil. It carries no nonce, so a signature can be replayed by anyone who holds it until it expires. Keep validitySeconds tight, and treat a signed price as a bearer credential over its lifetime. Verify a signature without spending gas using Verify Signed Price.

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

const signRes = await fetch(
  `https://api.trusset.org/lending-external-securities/api/markets/${marketId}/sign-price`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: 105.40, validitySeconds: 300 })
  }
);
const { data: signed } = await signRes.json();

const { domain, types, message } = signed.typedData;
const signature = await wallet._signTypedData(domain, types, message);

const loanRes = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/open-loan`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      collateralAmount: '1000',
      borrowAmount: '50000',
      signedPrice: {
        price: signed.price,
        timestamp: signed.timestamp,
        validUntil: signed.validUntil,
        signature
      }
    })
  }
);

{
  "success": true,
  "data": {
    "action": "SIGN_TYPED_DATA",
    "typedData": {
      "domain": {
        "name": "SecurityPriceOracle",
        "version": "1",
        "chainId": 11155111,
        "verifyingContract": "0x8B2e...4a7c"
      },
      "types": {
        "PriceUpdate": [
          { "name": "price", "type": "uint256" },
          { "name": "timestamp", "type": "uint256" },
          { "name": "validUntil", "type": "uint256" }
        ]
      },
      "primaryType": "PriceUpdate",
      "message": {
        "price": "105400000",
        "timestamp": 1718445600,
        "validUntil": 1718445900
      }
    },
    "display": {
      "price": "105400000",
      "priceUsd": "105.4",
      "timestamp": 1718445600,
      "validUntil": 1718445900,
      "signer": "0x123...456"
    },
    "price": "105400000",
    "priceUsd": "105.4",
    "timestamp": 1718445600,
    "validUntil": 1718445900,
    "signer": "0x123...456"
  }
}

{
  "success": false,
  "error": {
    "code": "SIGNING_FAILED",
    "message": "Issuer wallet 0x123...456 not authorized on oracle. Authorize it via setAuthorizedSigner first."
  }
}

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

Every failure returns code SIGNING_FAILED. The specific cause, whether no registered wallet or a missing oracle authorization, is in message.

Sync Oracle Price

Verify Signed Price

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

const signRes = await fetch(
  `https://api.trusset.org/lending-external-securities/api/markets/${marketId}/sign-price`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: 105.40, validitySeconds: 300 })
  }
);
const { data: signed } = await signRes.json();

const { domain, types, message } = signed.typedData;
const signature = await wallet._signTypedData(domain, types, message);

const loanRes = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/open-loan`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      collateralAmount: '1000',
      borrowAmount: '50000',
      signedPrice: {
        price: signed.price,
        timestamp: signed.timestamp,
        validUntil: signed.validUntil,
        signature
      }
    })
  }
);

{
  "success": true,
  "data": {
    "action": "SIGN_TYPED_DATA",
    "typedData": {
      "domain": {
        "name": "SecurityPriceOracle",
        "version": "1",
        "chainId": 11155111,
        "verifyingContract": "0x8B2e...4a7c"
      },
      "types": {
        "PriceUpdate": [
          { "name": "price", "type": "uint256" },
          { "name": "timestamp", "type": "uint256" },
          { "name": "validUntil", "type": "uint256" }
        ]
      },
      "primaryType": "PriceUpdate",
      "message": {
        "price": "105400000",
        "timestamp": 1718445600,
        "validUntil": 1718445900
      }
    },
    "display": {
      "price": "105400000",
      "priceUsd": "105.4",
      "timestamp": 1718445600,
      "validUntil": 1718445900,
      "signer": "0x123...456"
    },
    "price": "105400000",
    "priceUsd": "105.4",
    "timestamp": 1718445600,
    "validUntil": 1718445900,
    "signer": "0x123...456"
  }
}

{
  "success": false,
  "error": {
    "code": "SIGNING_FAILED",
    "message": "Issuer wallet 0x123...456 not authorized on oracle. Authorize it via setAuthorizedSigner first."
  }
}

{
  "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

Sign Price

Path Parameters

Body Parameters

Response Fields

Signature Structure

​Path Parameters

​Body Parameters

​Response Fields

​Signature Structure

Path Parameters

Body Parameters

Response Fields

Signature Structure