Lender of Record
Get Operator
Read who holds a market lender-of-record role and what it has accrued
GET
/
lending-external-securities-v2
/
api
/
markets
/
{marketId}
/
operator
curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/operator" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/operator`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const canLend = data.status === 'active';
{
"success": true,
"data": {
"status": "active",
"operator": {
"wallet": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"companyName": "Example Lender AG",
"profileImage": null,
"isBank": true,
"verified": true,
"instanceName": "Lending desk",
"walletLabel": "Treasury",
"acceptedAt": "2026-09-26T10:41:12.000Z",
"acceptTxHash": "0x5d8e2a41c7b93f06e1d4a8c25b7f90e3d6a1c48b2e5f7093a4d6c81b5e2f7a90"
},
"actions": [
{
"id": "sectx_0192",
"txType": "CURATOR_ACCEPTED",
"userAddress": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"amount": "0",
"txHash": "0x5d8e2a41c7b93f06e1d4a8c25b7f90e3d6a1c48b2e5f7093a4d6c81b5e2f7a90",
"timestamp": "2026-09-26T10:41:12.000Z"
}
],
"actionsFailed": false,
"fees": {
"shareBps": "800",
"recipient": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"payable": "0.0",
"payableRaw": "0",
"asset": {
"address": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"symbol": "USDC",
"decimals": 6
},
"sweepable": false,
"readFailed": false,
"fixedShare": true
},
"marketFees": {
"readFailed": false,
"asset": {
"address": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"symbol": "USDC",
"decimals": 6
},
"feeShareGeneration": "FIXED_SHARES",
"operator": {
"shareBps": "800",
"recipient": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"payable": "0.0",
"payableRaw": "0",
"asset": {
"address": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"symbol": "USDC",
"decimals": 6
},
"sweepable": false,
"readFailed": false,
"fixedShare": true
},
"distributor": {
"shareBps": "500",
"payable": "0.0",
"payableRaw": "0",
"registeredVaults": [],
"reRegistration": {
"pending": [],
"unread": [],
"predatingDistributor": []
},
"operatorPosition": {
"provider": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"claim": "0.0",
"claimRaw": "0",
"sweepable": false
},
"paidTo": "VAULTS_AND_OPERATOR_WALLET"
},
"protocol": {
"payable": "0.0",
"payableRaw": "0",
"destination": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
"sweepable": false
},
"infrastructure": {
"payable": "0.0",
"payableRaw": "0",
"destination": "0x7d3a5e19c2b84f60a1e9d7c3b5f28a4e6c0d1b93",
"sweepable": false
}
}
}
}
{
"success": true,
"data": {
"status": "awaiting",
"operator": null,
"actions": [],
"actionsFailed": false,
"fees": null,
"marketFees": null
}
}
Returns who operates the market as lender of record, the institution behind that wallet, its recent actions on the market, and the fees the market has accrued. Gate a borrow control on it: a market still seeking a lender of record refuses every loan. See Lender of record.
The call first reconciles this instance’s record of the market with the lending factory. A lender of record takes the role from its own instance, so this is how the deploying instance learns that its market was adopted. Get Nominations serves the reconciled values afterwards.
A factory or ledger that cannot be read does not fail the call. The reconciliation is skipped, and an unreadable ledger or fee read is flagged in
status decides the shape. awaiting means the market still seeks a lender of record. none means no operator wallet is recorded. active means a lender of record holds the role, and only then are operator, fees and marketFees filled in.
Path Parameters
Response Fields
Show child attributes
Show child attributes
The lender of record, or
null unless status is active.Show child attributes
Show child attributes
Up to 50 of the most recent ledger entries on this market made by the operator’s wallets, newest first, each
{ id, txType, userAddress, amount, txHash, timestamp }. Empty unless status is active.Every fee leg the market has booked and not yet swept, read live.
null unless status is active.Show child attributes
Show child attributes
FIXED_SHARES: the market pays the fixed operator and distributor shares. null when unreadable.{ shareBps, recipient, payable, payableRaw, asset, sweepable, readFailed, fixedShare }, with fixedShare: true. recipient is the market’s operator wallet. payable is formatted in the settlement asset and payableRaw is in its smallest unit. Swept with Sweep Operator Fees.The distributor leg. It carries
shareBps, payable, payableRaw, registeredVaults, reRegistration, operatorPosition and paidTo. operatorPosition is the distributor share accrued on the operator wallet’s direct position, swept with Sweep Distributor Fees.{ payable, payableRaw, destination, sweepable }. destination is the market’s insurance fund. Swept with Sweep Protocol Fees.The operator wallet that receives the operator share can differ from the wallet that took the role. The lender of record rotates it with Rotate Operator Wallet, and
marketFees.operator.recipient reads the wallet in force.curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/operator" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/operator`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const canLend = data.status === 'active';
{
"success": true,
"data": {
"status": "active",
"operator": {
"wallet": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"companyName": "Example Lender AG",
"profileImage": null,
"isBank": true,
"verified": true,
"instanceName": "Lending desk",
"walletLabel": "Treasury",
"acceptedAt": "2026-09-26T10:41:12.000Z",
"acceptTxHash": "0x5d8e2a41c7b93f06e1d4a8c25b7f90e3d6a1c48b2e5f7093a4d6c81b5e2f7a90"
},
"actions": [
{
"id": "sectx_0192",
"txType": "CURATOR_ACCEPTED",
"userAddress": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"amount": "0",
"txHash": "0x5d8e2a41c7b93f06e1d4a8c25b7f90e3d6a1c48b2e5f7093a4d6c81b5e2f7a90",
"timestamp": "2026-09-26T10:41:12.000Z"
}
],
"actionsFailed": false,
"fees": {
"shareBps": "800",
"recipient": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"payable": "0.0",
"payableRaw": "0",
"asset": {
"address": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"symbol": "USDC",
"decimals": 6
},
"sweepable": false,
"readFailed": false,
"fixedShare": true
},
"marketFees": {
"readFailed": false,
"asset": {
"address": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"symbol": "USDC",
"decimals": 6
},
"feeShareGeneration": "FIXED_SHARES",
"operator": {
"shareBps": "800",
"recipient": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"payable": "0.0",
"payableRaw": "0",
"asset": {
"address": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"symbol": "USDC",
"decimals": 6
},
"sweepable": false,
"readFailed": false,
"fixedShare": true
},
"distributor": {
"shareBps": "500",
"payable": "0.0",
"payableRaw": "0",
"registeredVaults": [],
"reRegistration": {
"pending": [],
"unread": [],
"predatingDistributor": []
},
"operatorPosition": {
"provider": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"claim": "0.0",
"claimRaw": "0",
"sweepable": false
},
"paidTo": "VAULTS_AND_OPERATOR_WALLET"
},
"protocol": {
"payable": "0.0",
"payableRaw": "0",
"destination": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
"sweepable": false
},
"infrastructure": {
"payable": "0.0",
"payableRaw": "0",
"destination": "0x7d3a5e19c2b84f60a1e9d7c3b5f28a4e6c0d1b93",
"sweepable": false
}
}
}
}
{
"success": true,
"data": {
"status": "awaiting",
"operator": null,
"actions": [],
"actionsFailed": false,
"fees": null,
"marketFees": null
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
MISSING_MARKET_ID | 400 | marketId is longer than 100 characters |
MARKET_NOT_FOUND | 404 | No market with this ID on your instance |
actionsFailed or marketFees.readFailed.⌘I
curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/operator" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/operator`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const canLend = data.status === 'active';
{
"success": true,
"data": {
"status": "active",
"operator": {
"wallet": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"companyName": "Example Lender AG",
"profileImage": null,
"isBank": true,
"verified": true,
"instanceName": "Lending desk",
"walletLabel": "Treasury",
"acceptedAt": "2026-09-26T10:41:12.000Z",
"acceptTxHash": "0x5d8e2a41c7b93f06e1d4a8c25b7f90e3d6a1c48b2e5f7093a4d6c81b5e2f7a90"
},
"actions": [
{
"id": "sectx_0192",
"txType": "CURATOR_ACCEPTED",
"userAddress": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"amount": "0",
"txHash": "0x5d8e2a41c7b93f06e1d4a8c25b7f90e3d6a1c48b2e5f7093a4d6c81b5e2f7a90",
"timestamp": "2026-09-26T10:41:12.000Z"
}
],
"actionsFailed": false,
"fees": {
"shareBps": "800",
"recipient": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"payable": "0.0",
"payableRaw": "0",
"asset": {
"address": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"symbol": "USDC",
"decimals": 6
},
"sweepable": false,
"readFailed": false,
"fixedShare": true
},
"marketFees": {
"readFailed": false,
"asset": {
"address": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"symbol": "USDC",
"decimals": 6
},
"feeShareGeneration": "FIXED_SHARES",
"operator": {
"shareBps": "800",
"recipient": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"payable": "0.0",
"payableRaw": "0",
"asset": {
"address": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"symbol": "USDC",
"decimals": 6
},
"sweepable": false,
"readFailed": false,
"fixedShare": true
},
"distributor": {
"shareBps": "500",
"payable": "0.0",
"payableRaw": "0",
"registeredVaults": [],
"reRegistration": {
"pending": [],
"unread": [],
"predatingDistributor": []
},
"operatorPosition": {
"provider": "0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93",
"claim": "0.0",
"claimRaw": "0",
"sweepable": false
},
"paidTo": "VAULTS_AND_OPERATOR_WALLET"
},
"protocol": {
"payable": "0.0",
"payableRaw": "0",
"destination": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
"sweepable": false
},
"infrastructure": {
"payable": "0.0",
"payableRaw": "0",
"destination": "0x7d3a5e19c2b84f60a1e9d7c3b5f28a4e6c0d1b93",
"sweepable": false
}
}
}
}
{
"success": true,
"data": {
"status": "awaiting",
"operator": null,
"actions": [],
"actionsFailed": false,
"fees": null,
"marketFees": null
}
}
