Trusset Protocol - Infrastructure for Asset Tokenization

GET

orderbooks

stocks

api

custody

{custodyContract}

balance

{userAddress}

{tokenAddress}

curl "https://api.trusset.org/orderbooks/stocks/api/custody/0x98c33b10823172e62a31d6048773df1054c4f821/balance/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/0x98ad0ca091552e23c564b41c74282e5343d03e8a" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/orderbooks/stocks/api/custody/${custody}/balance/${user}/${token}`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(ethers.utils.formatUnits(data.available, 6), 'USDC free');

{
  "success": true,
  "data": {
    "total": "50000000000",
    "locked": "9117500000",
    "available": "40882500000"
  }
}

Returns what one wallet holds of one token inside a custody contract, split into what is free and what is committed to resting orders. Amounts are on-chain base units in the token’s own decimals, not order book units. Convert before comparing against an order’s quantity or price. The contract is read live. If the read fails, the endpoint answers with zeros rather than an error, so a zero balance and an unreachable node look alike. Treat a sudden zero as suspect if the wallet was funded.

Path Parameters

string

required

Custody contract address. Which flavour it is decides how the balance is read, resolved from your instance’s network.

string

required

Wallet to read.

string

required

Token to read. Either side of a pair.

Response Fields

object

Show child attributes

string

Everything the wallet holds in custody, in the token’s base units.

string

Amount committed to resting orders and pending settlements.

string

Free balance, total minus locked. This is what a new order can draw on.

Off-chain books hold no custody contract. Balances for off-chain trading live in your instance’s custody ledger and are keyed by customerRef, not by wallet.

curl "https://api.trusset.org/orderbooks/stocks/api/custody/0x98c33b10823172e62a31d6048773df1054c4f821/balance/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/0x98ad0ca091552e23c564b41c74282e5343d03e8a" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/orderbooks/stocks/api/custody/${custody}/balance/${user}/${token}`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(ethers.utils.formatUnits(data.available, 6), 'USDC free');

{
  "success": true,
  "data": {
    "total": "50000000000",
    "locked": "9117500000",
    "available": "40882500000"
  }
}

Error Codes

Code	HTTP	Cause
`VALIDATION_ERROR`	`400`	One of the three path addresses is malformed
`SERVICE_NOT_ENABLED`	`403`	The Trading service is not enabled on this instance

curl "https://api.trusset.org/orderbooks/stocks/api/custody/0x98c33b10823172e62a31d6048773df1054c4f821/balance/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3/0x98ad0ca091552e23c564b41c74282e5343d03e8a" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/orderbooks/stocks/api/custody/${custody}/balance/${user}/${token}`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(ethers.utils.formatUnits(data.available, 6), 'USDC free');

{
  "success": true,
  "data": {
    "total": "50000000000",
    "locked": "9117500000",
    "available": "40882500000"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Get Custody Balance

Path Parameters

Response Fields

Error Codes

​Path Parameters

​Response Fields

​Error Codes

Path Parameters

Response Fields

Error Codes