Markets
List Markets
List all active external securities lending markets for your instance
GET
/
lending-external-securities
/
api
/
markets
curl "https://api.trusset.org/lending-external-securities/api/markets?includeOnChain=true" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/lending-external-securities/api/markets?includeOnChain=true',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const m of data.markets) {
const live = m.onChain?.isOnChain ? m.onChain : null;
console.log(m.collateralTokenSymbol, m.collateralMode, live?.availableLiquidity ?? 'unavailable');
}
{
"success": true,
"data": {
"markets": [
{
"id": "clx_secmarket_001",
"marketAddress": "0x70A0E25c7b768B87e658348B3b577678A173E038",
"oracleAddress": "0x3b25752c1459C5Cf1b0bfcFdF0D56883c8047423",
"insuranceFundAddress": "0x8f1a...9c22",
"adapterAddress": "0x4d2b...77ae",
"liquidationRouterAddress": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
"collateralAgent": "0x555...666",
"liquidationOperator": "0x777...888",
"priceSource": "NAV",
"collateralTokenAddress": "0xabc...def",
"collateralTokenName": "Nyala Fund I",
"collateralTokenSymbol": "NYF1",
"collateralTokenIsin": "DE000A0F5UF5",
"collateralMode": "FREEZE",
"collateralFactor": "7500",
"liquidationThreshold": "8500",
"closeFactor": "5000",
"useDutchAuction": false,
"totalDeposits": "1000000",
"totalBorrows": "250000",
"utilizationRate": "2500",
"borrowRate": "450",
"supplyRate": "84",
"active": true,
"createdAt": "2025-06-01T09:00:00.000Z",
"isOnChain": true,
"onChain": {
"isOnChain": true,
"paused": false,
"totalDeposits": "1000000.000000",
"totalBorrows": "250000.000000",
"availableLiquidity": "750000.000000",
"utilizationRate": "2500",
"borrowRate": "450",
"supplyRate": "84",
"activeLoans": 4,
"activeAuctions": 0,
"pendingLiquidations": 0,
"pendingLiquidationDebt": "0.000000"
}
}
]
},
"metadata": {
"timestamp": "2025-06-15T12:00:00.000Z",
"requestId": "a1b2c3d4-...",
"instanceId": "inst_abc123"
}
}
Returns every active market deployed under the instance bound to your API key. Archived and inactive markets are excluded.
The stored aggregates are served by default and
onChain is null. Live per-market state is opt-in through includeOnChain, because enriching a list runs a full position sync per market and turns a list read into an unbounded chain scan. For live state on a single market, prefer Get Market or Get Market Metrics.
When enrichment is requested it is still best effort. If the RPC is unreachable for a given market, onChain comes back null and the stored fields are served regardless. Always check onChain before reading from it.
Query Parameters
boolean
default:"false"
Set to
true to read live contract state for every market in the list. Any other value leaves onChain as null.Response Fields
object
Show child attributes
Show child attributes
array
Show child attributes
Show child attributes
string
Market ID. Use this as
marketId on every other endpoint.string
Lending market contract.
string
Price oracle contract.
string
Insurance fund contract.
string
Collateral adapter. A freeze adapter in
FREEZE mode, a custody adapter in CUSTODY mode.string
This market’s dedicated liquidation router. Markets deployed before per-market routers fall back to the shared legacy router.
string
Named pledgee recorded on the market and on every adapter lock.
string
Address holding
OPERATOR_ROLE on this market’s liquidation router.string
NAV or MARKET.string
ERC-3643 security token accepted as collateral.
string
Collateral token name.
string
Collateral token symbol.
string
ISIN of the underlying security, when recorded.
string
FREEZE or CUSTODY.string
Maximum loan to value in basis points.
string
Liquidation trigger in basis points.
string
Maximum fraction of debt repayable in one liquidation, in basis points.
boolean
Whether liquidations open a Dutch auction.
string
Last recorded pool deposits.
string
Last recorded outstanding borrows.
string
Last recorded utilization in basis points.
string
Last recorded borrow rate in basis points.
string
Last recorded supply rate in basis points.
boolean
Always true in this response.
string
ISO 8601 timestamp.
boolean
Whether the market has a deployed address recorded.
object
Live contract metrics.
null unless includeOnChain=true, and null when the read failed. See Get Market Metrics for the full field list.Database totals on the market record are refreshed after write operations executed through this API. Treat the
onChain block as authoritative for live figures.curl "https://api.trusset.org/lending-external-securities/api/markets?includeOnChain=true" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/lending-external-securities/api/markets?includeOnChain=true',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const m of data.markets) {
const live = m.onChain?.isOnChain ? m.onChain : null;
console.log(m.collateralTokenSymbol, m.collateralMode, live?.availableLiquidity ?? 'unavailable');
}
{
"success": true,
"data": {
"markets": [
{
"id": "clx_secmarket_001",
"marketAddress": "0x70A0E25c7b768B87e658348B3b577678A173E038",
"oracleAddress": "0x3b25752c1459C5Cf1b0bfcFdF0D56883c8047423",
"insuranceFundAddress": "0x8f1a...9c22",
"adapterAddress": "0x4d2b...77ae",
"liquidationRouterAddress": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
"collateralAgent": "0x555...666",
"liquidationOperator": "0x777...888",
"priceSource": "NAV",
"collateralTokenAddress": "0xabc...def",
"collateralTokenName": "Nyala Fund I",
"collateralTokenSymbol": "NYF1",
"collateralTokenIsin": "DE000A0F5UF5",
"collateralMode": "FREEZE",
"collateralFactor": "7500",
"liquidationThreshold": "8500",
"closeFactor": "5000",
"useDutchAuction": false,
"totalDeposits": "1000000",
"totalBorrows": "250000",
"utilizationRate": "2500",
"borrowRate": "450",
"supplyRate": "84",
"active": true,
"createdAt": "2025-06-01T09:00:00.000Z",
"isOnChain": true,
"onChain": {
"isOnChain": true,
"paused": false,
"totalDeposits": "1000000.000000",
"totalBorrows": "250000.000000",
"availableLiquidity": "750000.000000",
"utilizationRate": "2500",
"borrowRate": "450",
"supplyRate": "84",
"activeLoans": 4,
"activeAuctions": 0,
"pendingLiquidations": 0,
"pendingLiquidationDebt": "0.000000"
}
}
]
},
"metadata": {
"timestamp": "2025-06-15T12:00:00.000Z",
"requestId": "a1b2c3d4-...",
"instanceId": "inst_abc123"
}
}
⌘I
curl "https://api.trusset.org/lending-external-securities/api/markets?includeOnChain=true" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/lending-external-securities/api/markets?includeOnChain=true',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const m of data.markets) {
const live = m.onChain?.isOnChain ? m.onChain : null;
console.log(m.collateralTokenSymbol, m.collateralMode, live?.availableLiquidity ?? 'unavailable');
}
{
"success": true,
"data": {
"markets": [
{
"id": "clx_secmarket_001",
"marketAddress": "0x70A0E25c7b768B87e658348B3b577678A173E038",
"oracleAddress": "0x3b25752c1459C5Cf1b0bfcFdF0D56883c8047423",
"insuranceFundAddress": "0x8f1a...9c22",
"adapterAddress": "0x4d2b...77ae",
"liquidationRouterAddress": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
"collateralAgent": "0x555...666",
"liquidationOperator": "0x777...888",
"priceSource": "NAV",
"collateralTokenAddress": "0xabc...def",
"collateralTokenName": "Nyala Fund I",
"collateralTokenSymbol": "NYF1",
"collateralTokenIsin": "DE000A0F5UF5",
"collateralMode": "FREEZE",
"collateralFactor": "7500",
"liquidationThreshold": "8500",
"closeFactor": "5000",
"useDutchAuction": false,
"totalDeposits": "1000000",
"totalBorrows": "250000",
"utilizationRate": "2500",
"borrowRate": "450",
"supplyRate": "84",
"active": true,
"createdAt": "2025-06-01T09:00:00.000Z",
"isOnChain": true,
"onChain": {
"isOnChain": true,
"paused": false,
"totalDeposits": "1000000.000000",
"totalBorrows": "250000.000000",
"availableLiquidity": "750000.000000",
"utilizationRate": "2500",
"borrowRate": "450",
"supplyRate": "84",
"activeLoans": 4,
"activeAuctions": 0,
"pendingLiquidations": 0,
"pendingLiquidationDebt": "0.000000"
}
}
]
},
"metadata": {
"timestamp": "2025-06-15T12:00:00.000Z",
"requestId": "a1b2c3d4-...",
"instanceId": "inst_abc123"
}
}