Deployment
Get Nominations
Read the candidates nominated to become a market lender of record
GET
/
lending-external-securities-v2
/
api
/
markets
/
{marketId}
/
nominations
curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/nominations" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/nominations`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
if (data.seekingCurator) {
showPendingBanner(data.candidates);
}
{
"success": true,
"data": {
"candidates": [
"0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"0xb27d0f6a91c458e307b2d4f8916ac05e73128b64"
],
"curator": null,
"seekingCurator": true,
"realizationMode": "UNDECLARED"
}
}
{
"success": true,
"data": {
"candidates": [
"0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"0xb27d0f6a91c458e307b2d4f8916ac05e73128b64"
],
"curator": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"seekingCurator": false,
"realizationMode": "ISSUER_REDEMPTION"
}
}
Returns the addresses currently nominated to take this market’s lender-of-record role, together with whether the role has been taken and on what realization path. See Lender of record.
The candidate list is read live from the lending factory, so it reflects every nomination made at deployment or later through Nominate Candidate, minus withdrawn ones. Adoption does not clear it: a market that has a lender of record still lists its candidates.
curator, seekingCurator and realizationMode come from the market as this instance records it, not from the factory. A candidate takes the role from its own instance, so the deploying instance’s record can lag an adoption. Get Market and Get Operator reconcile the record with the factory, and this endpoint serves the reconciled values afterwards.
Until a lender of record takes the role, opening a loan, borrowing more and providing liquidity are refused with 409 MARKET_PENDING_CURATOR. That refusal reads the market contract itself, so it holds even while this record lags.
Path Parameters
string
required
Response Fields
object
Show child attributes
Show child attributes
array
Nominated addresses, lowercased and deduplicated. Empty when nobody is nominated, or when the factory could not be read.
string
Address that holds the lender-of-record role, as recorded on this instance. Null while the record shows the market seeking one.
boolean
Whether the recorded market is still seeking a lender of record.
string
How seized collateral is realized, as the lender of record declared it:
EXCHANGE_SALE, ISSUER_REDEMPTION or AUCTION. UNDECLARED before adoption, and null when the market records none.curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/nominations" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/nominations`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
if (data.seekingCurator) {
showPendingBanner(data.candidates);
}
{
"success": true,
"data": {
"candidates": [
"0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"0xb27d0f6a91c458e307b2d4f8916ac05e73128b64"
],
"curator": null,
"seekingCurator": true,
"realizationMode": "UNDECLARED"
}
}
{
"success": true,
"data": {
"candidates": [
"0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"0xb27d0f6a91c458e307b2d4f8916ac05e73128b64"
],
"curator": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"seekingCurator": false,
"realizationMode": "ISSUER_REDEMPTION"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
NO_MARKET_ADDRESS | 400 | The market has no on-chain address |
MISSING_MARKET_ID | 400 | marketId is longer than 100 characters |
MARKET_NOT_FOUND | 404 | No market with this ID on your instance |
⌘I
curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/nominations" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/nominations`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
if (data.seekingCurator) {
showPendingBanner(data.candidates);
}
{
"success": true,
"data": {
"candidates": [
"0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"0xb27d0f6a91c458e307b2d4f8916ac05e73128b64"
],
"curator": null,
"seekingCurator": true,
"realizationMode": "UNDECLARED"
}
}
{
"success": true,
"data": {
"candidates": [
"0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"0xb27d0f6a91c458e307b2d4f8916ac05e73128b64"
],
"curator": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"seekingCurator": false,
"realizationMode": "ISSUER_REDEMPTION"
}
}