RescueLoan
Rescues a distressed loan by providing additional currency units. Any party can participate in rescuing a loan.
Request
POST /nxt?requestType=rescueLoan
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
secretPhrase | string | Rescuer's secret passphrase | Yes |
loan | long | Loan ID to rescue | Yes |
currency | long | Currency ID | Yes |
unitsQNT | long | Number of units to contribute | Yes |
feeRateQNTPerFXT | long | Transaction fee rate | Optional |
deadline | int | Transaction deadline in minutes | Optional |
Constraints
- The loan must not already be repaid or rescued
- The rescuer cannot be the original loan borrower
- The currency must match the loan's currency
- The rescue amount must be valid per the loan's interest calculation
Response
{
"transaction": "1234567890123456789",
"fullHash": "abc123...",
"errorCode": 0,
"errorDescription": ""
}
Error Handling
| Error | Condition |
|---|---|
LOAN_REPAID | Loan is already repaid or rescued |
INCORRECT_LOAN | Loan is not eligible for rescue |
INCORRECT_CURRENCY | Currency does not match loan |
INCORRECT_LOAN_AMOUNT | Invalid rescue amount |
NOT_ENOUGH_CURRENCY | Insufficient currency balance |
Example
curl -X POST http://localhost:22024/nxt \
-d "requestType=rescueLoan" \
-d "secretPhrase=your_phrase" \
-d "loan=55555" \
-d "currency=987654321" \
-d "unitsQNT=500000000"