Loan Approvals
List Loan Requests
List the loan requests of a market
GET
/
lending-external-securities-v2
/
api
/
markets
/
{marketId}
/
loan-requests
List Loan Requests
curl --request GET \
--url https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests \
--header 'x-api-key: <api-key>'import requests
url = "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"requests": [
{
"ref": "lrq_k3vx7q2mwd4h5pn6tr2a",
"kind": "OPEN",
"loanId": null,
"status": "REQUESTED",
"marketAddress": "0x41b9c4d5dee70a5e3682094462e5065275e728a9",
"borrowerWallet": "0x7c1e3a5f2b9d4e6a8c0f1b3d5e7a9c2b4d6f8e1a",
"externalReference": "CASE-2026.11_042",
"amount": "25000",
"amountRaw": "25000000000",
"collateralAmount": "40",
"symbol": "USDC",
"decimals": 6,
"approvedAmount": null,
"approvedAmountRaw": null,
"validUntil": null,
"approver": null,
"approveTxHash": null,
"decidedAt": null,
"usedTxHash": null,
"usedAt": null,
"createdAt": "2026-11-21T16:02:11.000Z",
"updatedAt": "2026-11-21T16:02:11.000Z",
"requestedByThisInstance": false,
"viewerRole": {
"bank": true,
"borrower": false
},
"nextStep": "APPROVE_OR_DECLINE"
}
],
"total": 1,
"limit": 200,
"offset": 0,
"truncated": false,
"waiting": 1,
"mode": {
"supported": true,
"available": true,
"enabled": true,
"requested": false,
"approvals": "0x5d2e8c1a7f4b3960e2d1c8a7b6f5e4d3c2b1a098",
"canonical": true,
"upgradeRequired": false,
"approverRole": "0x46f54e51673dd785402ec1df75a85f2b1da1abc02695cc95d95578f830f58153",
"maxValidHours": 696,
"viewer": {
"isBank": true,
"isAdmin": true,
"approverWallets": [
"0x7712db30a7b4ffd9c445793089118b60e56d752a"
]
}
},
"viewer": {
"isBank": true
},
"marketId": "cmwfk2h7x0003jw9w4q8b2n1c"
},
"error": null
}
Lists the market’s loan requests. The lender of record sees every request of the market. Any other instance sees the requests it made and those naming one of its verified wallets.
The list is paged with
limit and offset. Without a status filter, open requests come first: REQUESTED, then APPROVED, then the rest, each with the newest change first. A waiting request is never cut off by newer history. With a status filter, the newest change comes first.
Path Parameters
Query Parameters
One status:
REQUESTED, APPROVED, USED, DECLINED, WITHDRAWN, REVOKED, EXPIRED or CLOSED. Any other value answers 400 INVALID_STATUS.Response Fields
Show child attributes
Show child attributes
Each as Get Loan Request returns it.
How many requests your instance sees that are still
REQUESTED, whatever the page and the status filter. A borrower filter narrows it.The market’s mode. See Get Loan Approvals.
{
"success": true,
"data": {
"requests": [
{
"ref": "lrq_k3vx7q2mwd4h5pn6tr2a",
"kind": "OPEN",
"loanId": null,
"status": "REQUESTED",
"marketAddress": "0x41b9c4d5dee70a5e3682094462e5065275e728a9",
"borrowerWallet": "0x7c1e3a5f2b9d4e6a8c0f1b3d5e7a9c2b4d6f8e1a",
"externalReference": "CASE-2026.11_042",
"amount": "25000",
"amountRaw": "25000000000",
"collateralAmount": "40",
"symbol": "USDC",
"decimals": 6,
"approvedAmount": null,
"approvedAmountRaw": null,
"validUntil": null,
"approver": null,
"approveTxHash": null,
"decidedAt": null,
"usedTxHash": null,
"usedAt": null,
"createdAt": "2026-11-21T16:02:11.000Z",
"updatedAt": "2026-11-21T16:02:11.000Z",
"requestedByThisInstance": false,
"viewerRole": {
"bank": true,
"borrower": false
},
"nextStep": "APPROVE_OR_DECLINE"
}
],
"total": 1,
"limit": 200,
"offset": 0,
"truncated": false,
"waiting": 1,
"mode": {
"supported": true,
"available": true,
"enabled": true,
"requested": false,
"approvals": "0x5d2e8c1a7f4b3960e2d1c8a7b6f5e4d3c2b1a098",
"canonical": true,
"upgradeRequired": false,
"approverRole": "0x46f54e51673dd785402ec1df75a85f2b1da1abc02695cc95d95578f830f58153",
"maxValidHours": 696,
"viewer": {
"isBank": true,
"isAdmin": true,
"approverWallets": [
"0x7712db30a7b4ffd9c445793089118b60e56d752a"
]
}
},
"viewer": {
"isBank": true
},
"marketId": "cmwfk2h7x0003jw9w4q8b2n1c"
},
"error": null
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
INVALID_STATUS | 400 | status is not one of the eight statuses |
INVALID_WALLET | 400 | borrower is not an address |
VALIDATION_ERROR | 400 | limit is not a whole number from 1 to 200, or offset is not a whole number from 0 to 1000000 |
⌘I
List Loan Requests
curl --request GET \
--url https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests \
--header 'x-api-key: <api-key>'import requests
url = "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/loan-requests")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"requests": [
{
"ref": "lrq_k3vx7q2mwd4h5pn6tr2a",
"kind": "OPEN",
"loanId": null,
"status": "REQUESTED",
"marketAddress": "0x41b9c4d5dee70a5e3682094462e5065275e728a9",
"borrowerWallet": "0x7c1e3a5f2b9d4e6a8c0f1b3d5e7a9c2b4d6f8e1a",
"externalReference": "CASE-2026.11_042",
"amount": "25000",
"amountRaw": "25000000000",
"collateralAmount": "40",
"symbol": "USDC",
"decimals": 6,
"approvedAmount": null,
"approvedAmountRaw": null,
"validUntil": null,
"approver": null,
"approveTxHash": null,
"decidedAt": null,
"usedTxHash": null,
"usedAt": null,
"createdAt": "2026-11-21T16:02:11.000Z",
"updatedAt": "2026-11-21T16:02:11.000Z",
"requestedByThisInstance": false,
"viewerRole": {
"bank": true,
"borrower": false
},
"nextStep": "APPROVE_OR_DECLINE"
}
],
"total": 1,
"limit": 200,
"offset": 0,
"truncated": false,
"waiting": 1,
"mode": {
"supported": true,
"available": true,
"enabled": true,
"requested": false,
"approvals": "0x5d2e8c1a7f4b3960e2d1c8a7b6f5e4d3c2b1a098",
"canonical": true,
"upgradeRequired": false,
"approverRole": "0x46f54e51673dd785402ec1df75a85f2b1da1abc02695cc95d95578f830f58153",
"maxValidHours": 696,
"viewer": {
"isBank": true,
"isAdmin": true,
"approverWallets": [
"0x7712db30a7b4ffd9c445793089118b60e56d752a"
]
}
},
"viewer": {
"isBank": true
},
"marketId": "cmwfk2h7x0003jw9w4q8b2n1c"
},
"error": null
}
