Queries
List Vaults
Your instance’s vault first, then every published vault on your network
GET
/
lending-external-securities
/
api
/
vaults
curl "https://api.trusset.org/lending-external-securities/api/vaults" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/lending-external-securities/api/vaults',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const vault of data.vaults) {
console.log(`${vault.name} (${vault.symbol}), operated by ${vault.operatedBy?.issuerName}`);
}
{
"success": true,
"data": {
"vaults": [
{
"id": "cmssh8t2u0003cghxkx1w1fwd",
"instanceId": "inst_abc123",
"own": true,
"vaultAddress": "0x4d0cfe39a3431b145d1a1393d901a36d459a1b13",
"operatorWallet": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab",
"assetAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"assetSymbol": "USDC",
"assetDecimals": 6,
"identityRegistryAddress": "0xe9114c40934f6fb6bb317935156b731f7a86d006",
"name": "Trusset Prime Demo Vault",
"symbol": "TPV",
"performanceFeeBps": 500,
"active": true,
"archived": false,
"network": "ETHEREUM",
"settlementCurrency": "USD",
"riskDisclosure": "Deposits fund overcollateralized security-token lending markets. Value can fall as well as rise, and redemptions can fill partially under high utilization.",
"riskDisclosureUrl": "https://bank.example/vault-risk",
"operatedBy": {
"instanceName": "Trusset Client Demo",
"issuerName": "Trusset UG",
"image": null,
"profileImage": null,
"isBank": true
},
"onChain": {
"isOnChain": true,
"readFailed": false,
"totalAssets": "1250000.000000",
"totalShares": "1224489.795918",
"sharePrice": "1.020900000000000000",
"idleAssets": "312500.000000",
"allocatedAssets": "937500.000000",
"redeemableNow": "618200.000000",
"depositsPaused": false,
"performanceFeeBps": 500,
"assetsFullyReadable": true
},
"createdAt": "2026-08-13T21:10:00.000Z",
"updatedAt": "2026-08-14T06:40:00.000Z"
}
]
},
"error": null,
"metadata": {
"timestamp": "2026-08-14T12:00:00.000Z",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"instanceId": "inst_abc123"
}
}
Returns every vault visible to your instance: your own vault (if your instance operates one) marked
own: true, then every vault a bank issuer has published on your network and environment. A vault that exists but was never published is visible only to the instance operating it.
Every row carries an onChain block read from the vault contract, so a directory can show share price and size without a call per vault. What it does not carry is the per-holder position and the operator-only blocks, which are on Get Vault.
Response Fields
array
Show child attributes
Show child attributes
string
Vault ID. Every other vault endpoint takes this.
boolean
True when your instance operates this vault.
string
The vault contract.
null until the creation transaction is confirmed.string
The operator’s signing wallet, which owns the vault on-chain.
string
Settlement token address. Deposits, redemptions, and the share price are denominated in it.
string
Settlement token symbol, for example
USDC.integer
Settlement token decimals. Every amount you send is parsed at this precision, and every amount returned is formatted with it.
string
The register that admits depositors. Fixed for the life of the vault.
string
Vault name.
string
Share token symbol.
integer
Operator’s cut of the yield in basis points. The contract only accepts decreases.
boolean
True once the operator published the vault.
boolean
True when the operator retired the vault. Archived vaults are excluded from this list.
string
The chain the vault lives on, taken from the operating instance.
string
The fiat currency the vault’s asset settles in, resolved from the asset address rather than guessed from its symbol.
string
The operator’s risk statement. Show it before any deposit control.
string
Link to the operator’s full risk disclosure. Always
https.object
instanceName, issuerName, isBank, plus image and profileImage. Display the operator next to the vault name.performanceFeeBps on the row is reconciled against the fee the contract reports, and the lower of the two is served. A vault whose onChain read failed keeps the recorded value, which can be the higher one. Read the fee from onChain.performanceFeeBps when it is present.Your own vault comes first, then published vaults newest-first. Pin on
own if you re-sort client-side.curl "https://api.trusset.org/lending-external-securities/api/vaults" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/lending-external-securities/api/vaults',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const vault of data.vaults) {
console.log(`${vault.name} (${vault.symbol}), operated by ${vault.operatedBy?.issuerName}`);
}
{
"success": true,
"data": {
"vaults": [
{
"id": "cmssh8t2u0003cghxkx1w1fwd",
"instanceId": "inst_abc123",
"own": true,
"vaultAddress": "0x4d0cfe39a3431b145d1a1393d901a36d459a1b13",
"operatorWallet": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab",
"assetAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"assetSymbol": "USDC",
"assetDecimals": 6,
"identityRegistryAddress": "0xe9114c40934f6fb6bb317935156b731f7a86d006",
"name": "Trusset Prime Demo Vault",
"symbol": "TPV",
"performanceFeeBps": 500,
"active": true,
"archived": false,
"network": "ETHEREUM",
"settlementCurrency": "USD",
"riskDisclosure": "Deposits fund overcollateralized security-token lending markets. Value can fall as well as rise, and redemptions can fill partially under high utilization.",
"riskDisclosureUrl": "https://bank.example/vault-risk",
"operatedBy": {
"instanceName": "Trusset Client Demo",
"issuerName": "Trusset UG",
"image": null,
"profileImage": null,
"isBank": true
},
"onChain": {
"isOnChain": true,
"readFailed": false,
"totalAssets": "1250000.000000",
"totalShares": "1224489.795918",
"sharePrice": "1.020900000000000000",
"idleAssets": "312500.000000",
"allocatedAssets": "937500.000000",
"redeemableNow": "618200.000000",
"depositsPaused": false,
"performanceFeeBps": 500,
"assetsFullyReadable": true
},
"createdAt": "2026-08-13T21:10:00.000Z",
"updatedAt": "2026-08-14T06:40:00.000Z"
}
]
},
"error": null,
"metadata": {
"timestamp": "2026-08-14T12:00:00.000Z",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"instanceId": "inst_abc123"
}
}
⌘I
curl "https://api.trusset.org/lending-external-securities/api/vaults" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/lending-external-securities/api/vaults',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const vault of data.vaults) {
console.log(`${vault.name} (${vault.symbol}), operated by ${vault.operatedBy?.issuerName}`);
}
{
"success": true,
"data": {
"vaults": [
{
"id": "cmssh8t2u0003cghxkx1w1fwd",
"instanceId": "inst_abc123",
"own": true,
"vaultAddress": "0x4d0cfe39a3431b145d1a1393d901a36d459a1b13",
"operatorWallet": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab",
"assetAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"assetSymbol": "USDC",
"assetDecimals": 6,
"identityRegistryAddress": "0xe9114c40934f6fb6bb317935156b731f7a86d006",
"name": "Trusset Prime Demo Vault",
"symbol": "TPV",
"performanceFeeBps": 500,
"active": true,
"archived": false,
"network": "ETHEREUM",
"settlementCurrency": "USD",
"riskDisclosure": "Deposits fund overcollateralized security-token lending markets. Value can fall as well as rise, and redemptions can fill partially under high utilization.",
"riskDisclosureUrl": "https://bank.example/vault-risk",
"operatedBy": {
"instanceName": "Trusset Client Demo",
"issuerName": "Trusset UG",
"image": null,
"profileImage": null,
"isBank": true
},
"onChain": {
"isOnChain": true,
"readFailed": false,
"totalAssets": "1250000.000000",
"totalShares": "1224489.795918",
"sharePrice": "1.020900000000000000",
"idleAssets": "312500.000000",
"allocatedAssets": "937500.000000",
"redeemableNow": "618200.000000",
"depositsPaused": false,
"performanceFeeBps": 500,
"assetsFullyReadable": true
},
"createdAt": "2026-08-13T21:10:00.000Z",
"updatedAt": "2026-08-14T06:40:00.000Z"
}
]
},
"error": null,
"metadata": {
"timestamp": "2026-08-14T12:00:00.000Z",
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"instanceId": "inst_abc123"
}
}