Markets
Get Market
Retrieve full detail for a single market
GET
/
lending-external-securities
/
api
/
markets
/
{marketId}
curl "https://api.trusset.org/lending-external-securities/api/markets/{marketId}" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/lending-external-securities/api/markets/${marketId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(`${data.borrowAssetSymbol} market, ${data.collateralDecimals} collateral decimals`);
{
"success": true,
"data": {
"id": "clx_secmarket_001",
"marketAddress": "0x70A0E25c7b768B87e658348B3b577678A173E038",
"oracleAddress": "0x3b25752c1459C5Cf1b0bfcFdF0D56883c8047423",
"insuranceFundAddress": "0x8f1a...9c22",
"adapterAddress": "0x4d2b...77ae",
"identityRegistryAddress": "0x9e3c...1145",
"liquidationRouterAddress": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
"collateralTokenAddress": "0xabc...def",
"collateralTokenName": "Nyala Fund I",
"collateralTokenSymbol": "NYF1",
"collateralTokenIsin": "DE000A0F5UF5",
"collateralMode": "FREEZE",
"collateralDecimals": 18,
"borrowAssetAddress": "0x98aD0ca091552e23C564B41C74282e5343D03E8a",
"borrowAssetSymbol": "USDC",
"borrowAssetDecimals": 6,
"collateralAgent": "0x555...666",
"liquidationOperator": "0x777...888",
"priceSource": "NAV",
"collateralFactor": "7500",
"liquidationThreshold": "8500",
"liquidationBonus": "500",
"closeFactor": "5000",
"useDutchAuction": false,
"totalDeposits": "1000000",
"totalBorrows": "250000",
"utilizationRate": "2500",
"borrowRate": "450",
"supplyRate": "84",
"signerAuthorized": true,
"lastOracleUpdate": "2025-06-15T06:00:00.000Z",
"controllerImported": false,
"active": true,
"createdAt": "2025-06-01T09:00:00.000Z",
"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"
},
"oracleStatus": {
"price": "104.820000",
"isStale": false,
"priceAge": 1200,
"signerAuthorized": true
},
"configurationStatus": {
"liquidationConfigured": true,
"insuranceFundConfigured": true,
"adapterConfigured": true,
"routerAuthorized": true,
"fullyConfigured": true
},
"liquidationStats": {
"totalLiquidations": 0,
"pendingLiquidationDebt": "0.000000",
"totalAuctions": 0
}
}
}
{
"success": false,
"error": {
"code": "MARKET_NOT_FOUND",
"message": "Market not found"
}
}
Returns the complete market record plus four enrichment blocks read live from the chain:
onChain, oracleStatus, configurationStatus, and liquidationStats.
Unlike List Markets, which returns a fixed projection, this endpoint returns every stored field on the market, including the settlement asset triple and the decimals the backend uses when parsing your amounts.
All four enrichment blocks share one error boundary. If any on-chain read fails, the blocks populated so far are returned and the rest are
null. A null block signals an unavailable RPC, not a misconfigured market.Path Parameters
string
required
Market ID.
Response Fields
object
Show child attributes
Show child attributes
integer
Decimals of the collateral token. Every collateral amount you send is parsed at this precision, and every collateral amount returned is formatted with it.
string
Settlement token address.
string
Settlement token symbol.
integer
Settlement token decimals. Every borrow, repay, and liquidity amount is parsed at this precision.
string
ERC-3643 identity registry for the collateral token. The lowercased zero address means no registry was supplied at deployment.
string
Liquidator incentive in basis points.
boolean
Last recorded oracle signer authorization state.
oracleStatus.signerAuthorized is the live value.string
ISO 8601 timestamp of the last price push through this API.
boolean
True when this market was deployed under another instance and imported here by proving on-chain admin control.
object
Live market metrics. See Get Market Metrics.
object
Live oracle state. See Get Oracle Status.
object
Contract wiring state:
liquidationContract, insuranceFund, adapter, liquidationConfigured, insuranceFundConfigured, adapterConfigured, routerAuthorized, fullyConfigured.object
totalLiquidations, pendingLiquidationDebt, totalAuctions.The
configurationStatus block here covers contract wiring only. It does not include the token-side authorizations a market needs before loans can be opened. Use Get Configuration Status or Get Setup Steps for readiness.curl "https://api.trusset.org/lending-external-securities/api/markets/{marketId}" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/lending-external-securities/api/markets/${marketId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(`${data.borrowAssetSymbol} market, ${data.collateralDecimals} collateral decimals`);
{
"success": true,
"data": {
"id": "clx_secmarket_001",
"marketAddress": "0x70A0E25c7b768B87e658348B3b577678A173E038",
"oracleAddress": "0x3b25752c1459C5Cf1b0bfcFdF0D56883c8047423",
"insuranceFundAddress": "0x8f1a...9c22",
"adapterAddress": "0x4d2b...77ae",
"identityRegistryAddress": "0x9e3c...1145",
"liquidationRouterAddress": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
"collateralTokenAddress": "0xabc...def",
"collateralTokenName": "Nyala Fund I",
"collateralTokenSymbol": "NYF1",
"collateralTokenIsin": "DE000A0F5UF5",
"collateralMode": "FREEZE",
"collateralDecimals": 18,
"borrowAssetAddress": "0x98aD0ca091552e23C564B41C74282e5343D03E8a",
"borrowAssetSymbol": "USDC",
"borrowAssetDecimals": 6,
"collateralAgent": "0x555...666",
"liquidationOperator": "0x777...888",
"priceSource": "NAV",
"collateralFactor": "7500",
"liquidationThreshold": "8500",
"liquidationBonus": "500",
"closeFactor": "5000",
"useDutchAuction": false,
"totalDeposits": "1000000",
"totalBorrows": "250000",
"utilizationRate": "2500",
"borrowRate": "450",
"supplyRate": "84",
"signerAuthorized": true,
"lastOracleUpdate": "2025-06-15T06:00:00.000Z",
"controllerImported": false,
"active": true,
"createdAt": "2025-06-01T09:00:00.000Z",
"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"
},
"oracleStatus": {
"price": "104.820000",
"isStale": false,
"priceAge": 1200,
"signerAuthorized": true
},
"configurationStatus": {
"liquidationConfigured": true,
"insuranceFundConfigured": true,
"adapterConfigured": true,
"routerAuthorized": true,
"fullyConfigured": true
},
"liquidationStats": {
"totalLiquidations": 0,
"pendingLiquidationDebt": "0.000000",
"totalAuctions": 0
}
}
}
{
"success": false,
"error": {
"code": "MARKET_NOT_FOUND",
"message": "Market not found"
}
}
⌘I
curl "https://api.trusset.org/lending-external-securities/api/markets/{marketId}" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/lending-external-securities/api/markets/${marketId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(`${data.borrowAssetSymbol} market, ${data.collateralDecimals} collateral decimals`);
{
"success": true,
"data": {
"id": "clx_secmarket_001",
"marketAddress": "0x70A0E25c7b768B87e658348B3b577678A173E038",
"oracleAddress": "0x3b25752c1459C5Cf1b0bfcFdF0D56883c8047423",
"insuranceFundAddress": "0x8f1a...9c22",
"adapterAddress": "0x4d2b...77ae",
"identityRegistryAddress": "0x9e3c...1145",
"liquidationRouterAddress": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
"collateralTokenAddress": "0xabc...def",
"collateralTokenName": "Nyala Fund I",
"collateralTokenSymbol": "NYF1",
"collateralTokenIsin": "DE000A0F5UF5",
"collateralMode": "FREEZE",
"collateralDecimals": 18,
"borrowAssetAddress": "0x98aD0ca091552e23C564B41C74282e5343D03E8a",
"borrowAssetSymbol": "USDC",
"borrowAssetDecimals": 6,
"collateralAgent": "0x555...666",
"liquidationOperator": "0x777...888",
"priceSource": "NAV",
"collateralFactor": "7500",
"liquidationThreshold": "8500",
"liquidationBonus": "500",
"closeFactor": "5000",
"useDutchAuction": false,
"totalDeposits": "1000000",
"totalBorrows": "250000",
"utilizationRate": "2500",
"borrowRate": "450",
"supplyRate": "84",
"signerAuthorized": true,
"lastOracleUpdate": "2025-06-15T06:00:00.000Z",
"controllerImported": false,
"active": true,
"createdAt": "2025-06-01T09:00:00.000Z",
"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"
},
"oracleStatus": {
"price": "104.820000",
"isStale": false,
"priceAge": 1200,
"signerAuthorized": true
},
"configurationStatus": {
"liquidationConfigured": true,
"insuranceFundConfigured": true,
"adapterConfigured": true,
"routerAuthorized": true,
"fullyConfigured": true
},
"liquidationStats": {
"totalLiquidations": 0,
"pendingLiquidationDebt": "0.000000",
"totalAuctions": 0
}
}
}
{
"success": false,
"error": {
"code": "MARKET_NOT_FOUND",
"message": "Market not found"
}
}