GetLoan
Retrieves detailed information about a specific loan, including lender details.
Request
GET /nxt?requestType=getLoan
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
loan | long | Loan ID | Yes |
includeLenders | boolean | Include lender details | Optional |
Response
{
"loan": "55555",
"account": "1234567890",
"accountRS": "NXT-abcd-efgh-ijkl",
"chain": 1,
"unitsQNT": "1000000000",
"interestRate": 5,
"collateralTotem": "11111",
"totemQNT": "500000000",
"isFunded": true,
"raisedUnitsQNT": "500000000",
"creationHeight": 1000,
"issuanceHeight": 1000,
"repaymentHeight": 2000,
"repaidAmountQNT": "0",
"owedAmountQNT": "1050000000",
"isRepaid": false,
"isRescued": false,
"lenders": [
{
"account": "2222222222",
"accountRS": "NXT-zyxw-vuts-rqpo",
"unitsQNT": "250000000",
"height": 1500
}
]
}
Response Fields Description
| Field | Type | Description |
|---|---|---|
loan | string | Loan ID |
account | string | Borrower account ID |
accountRS | string | Borrower in NXT format |
chain | int | Beta chain ID |
unitsQNT | string | Loan amount in currency units |
interestRate | long | Interest rate percentage |
collateralTotem | string | Totem ID used as collateral |
totemQNT | string | Totem collateral amount |
isFunded | boolean | Whether the loan has been funded |
raisedUnitsQNT | string | Amount raised so far |
creationHeight | int | Block height of loan creation |
issuanceHeight | int | Block height when loan was issued |
repaymentHeight | int | Block height for repayment |
repaidAmountQNT | string | Amount already repaid |
owedAmountQNT | string | Remaining amount owed |
isRepaid | boolean | Whether the loan is fully repaid |
isRescued | boolean | Whether the loan was rescued |
lenders | array | Array of lender details (if includeLenders=true) |
Example
# Get loan details with lender info
curl "http://localhost:22024/nxt?requestType=getLoan&loan=55555&includeLenders=true"