Liquidity
List Liquidity Providers
List active liquidity providers for a market
GET
/
lending-external-securities
/
api
/
positions
/
{marketId}
/
providers
curl "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/providers" \
-H "X-API-Key: trusset_your_key_here"
{
"success": true,
"data": {
"providers": [
{
"id": "seclp_003",
"marketId": "clx_secmarket_001",
"provider": "0x111...222",
"amountDeposited": "250000",
"sharesOwned": "250000",
"active": true,
"depositedAt": "2025-06-08T14:20:00.000Z",
"withdrawnAt": null,
"source": "wallet"
},
{
"id": "seclp_004",
"marketId": "clx_secmarket_001",
"provider": "0x4d0cfe39a3431b145d1a1393d901a36d459a1b13",
"amountDeposited": "750000",
"sharesOwned": "735294",
"active": true,
"depositedAt": "2025-06-09T09:05:00.000Z",
"withdrawnAt": null,
"source": "vault",
"vault": {
"id": "cmssh8t2u0003cghxkx1w1fwd",
"name": "Trusset Prime Demo Vault",
"symbol": "TPV"
}
}
]
}
}
Returns the market’s active liquidity providers, newest deposit first. The endpoint reconciles against the chain before reading, so provider records reflect on-chain share balances where they can be resolved. If the RPC is unavailable the reconciliation is skipped and stored values are returned.
For an authoritative single-provider balance, use Get Provider Balance, which reads the market contract directly.
Path Parameters
string
required
Market ID.
Response Fields
object
Show child attributes
Show child attributes
array
Active provider records ordered by
depositedAt descending.Show child attributes
Show child attributes
string
Record ID.
string
Market ID.
string
Provider address, lowercased.
string
Deposited amount in borrow asset units.
string
LP shares held.
boolean
Always true in this response. Fully withdrawn providers are excluded.
string
ISO 8601 timestamp of the first deposit.
string
ISO 8601 timestamp of full withdrawal, or null.
string
wallet when the provider is a wallet supplying directly, vault when it is an operator vault funding the market on its depositors’ behalf.object
Present when
source is vault. Carries the vault’s id, and its name and symbol when the vault belongs to your instance. On another institution’s vault both are null: the funding is visible, the vault’s own identity is not.curl "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/providers" \
-H "X-API-Key: trusset_your_key_here"
{
"success": true,
"data": {
"providers": [
{
"id": "seclp_003",
"marketId": "clx_secmarket_001",
"provider": "0x111...222",
"amountDeposited": "250000",
"sharesOwned": "250000",
"active": true,
"depositedAt": "2025-06-08T14:20:00.000Z",
"withdrawnAt": null,
"source": "wallet"
},
{
"id": "seclp_004",
"marketId": "clx_secmarket_001",
"provider": "0x4d0cfe39a3431b145d1a1393d901a36d459a1b13",
"amountDeposited": "750000",
"sharesOwned": "735294",
"active": true,
"depositedAt": "2025-06-09T09:05:00.000Z",
"withdrawnAt": null,
"source": "vault",
"vault": {
"id": "cmssh8t2u0003cghxkx1w1fwd",
"name": "Trusset Prime Demo Vault",
"symbol": "TPV"
}
}
]
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
MARKET_NOT_FOUND | 404 | No market with this ID on your instance |
CHAIN_READ_FAILED | 503 | The provider set could not be read from the chain and nothing was recorded to fall back on. An empty list is never served in place of a failed read |
⌘I
curl "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/providers" \
-H "X-API-Key: trusset_your_key_here"
{
"success": true,
"data": {
"providers": [
{
"id": "seclp_003",
"marketId": "clx_secmarket_001",
"provider": "0x111...222",
"amountDeposited": "250000",
"sharesOwned": "250000",
"active": true,
"depositedAt": "2025-06-08T14:20:00.000Z",
"withdrawnAt": null,
"source": "wallet"
},
{
"id": "seclp_004",
"marketId": "clx_secmarket_001",
"provider": "0x4d0cfe39a3431b145d1a1393d901a36d459a1b13",
"amountDeposited": "750000",
"sharesOwned": "735294",
"active": true,
"depositedAt": "2025-06-09T09:05:00.000Z",
"withdrawnAt": null,
"source": "vault",
"vault": {
"id": "cmssh8t2u0003cghxkx1w1fwd",
"name": "Trusset Prime Demo Vault",
"symbol": "TPV"
}
}
]
}
}