Gavel Loan Status
get_loan_statusReturns the current state of a single Gavel loan and what action, if any, is available to whom. Designed to be re-called during a long conversation so lifecycle changes can be surfaced to the user.
'next_actions' is an array of {actor, action, calldata_tool} tuples naming the tool that prepares each transaction, so the next step can be taken without guessing. 'lifecycle_summary' gives the borrower's and lender's view in plain English.
This is descriptive data; no recommendation is provided. Verify on-chain before acting on a reported maturity or default.
Returns: { loan_id, state, borrower, lender, principal, repayment, apr, matures_at, time_remaining_seconds, outcome, next_actions }.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"loan_id": "<loan_id>"
},
"name": "get_loan_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| loan_id | Yes | The loan id. For v1 auctions this equals the auction id — see get_user_positions. |