curl -X POST 'https://api.stateset.com/v1/finance/loans/request' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"borrower_id": "did:stateset:borrower:def456",
"loan_amount": "25000.00",
"currency": "USDC",
"loan_purpose": "working_capital",
"term_months": 12,
"collateral": [
{
"type": "cryptocurrency",
"asset": "STATE",
"amount": "50000.00",
"current_value": "50000.00",
"ltv_ratio": 0.5
},
{
"type": "invoice",
"asset_id": "inv_78901",
"face_value": "15000.00",
"ltv_ratio": 0.8
}
],
"requested_rate": 0.08
}'
{
"loan_id": "loan_5z8nPq3oW7",
"status": "PENDING_APPROVAL",
"requested_amount": "25000.00",
"approved_amount": "25000.00",
"interest_rate": 0.075,
"term_months": 12,
"monthly_payment": "2256.50",
"total_collateral_value": "65000.00",
"ltv_ratio": 0.38,
"approval_time": "instant",
"funds_available": "2024-06-25T12:15:00Z"
}
Request Loan
Borrow against posted collateral — crypto, invoices, or inventory — with instant underwriting.
POST
/
v1
/
finance
/
loans
/
request
curl -X POST 'https://api.stateset.com/v1/finance/loans/request' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"borrower_id": "did:stateset:borrower:def456",
"loan_amount": "25000.00",
"currency": "USDC",
"loan_purpose": "working_capital",
"term_months": 12,
"collateral": [
{
"type": "cryptocurrency",
"asset": "STATE",
"amount": "50000.00",
"current_value": "50000.00",
"ltv_ratio": 0.5
},
{
"type": "invoice",
"asset_id": "inv_78901",
"face_value": "15000.00",
"ltv_ratio": 0.8
}
],
"requested_rate": 0.08
}'
{
"loan_id": "loan_5z8nPq3oW7",
"status": "PENDING_APPROVAL",
"requested_amount": "25000.00",
"approved_amount": "25000.00",
"interest_rate": 0.075,
"term_months": 12,
"monthly_payment": "2256.50",
"total_collateral_value": "65000.00",
"ltv_ratio": 0.38,
"approval_time": "instant",
"funds_available": "2024-06-25T12:15:00Z"
}
Legacy contract: confirm deployment before use. This page does not establish a
provisioned public service. Check the dated host report and obtain
a supported host and API version. New integrations should begin with the
API directory or local commerce walkthrough.
Overview
A loan request posts collateral and asks for a principal against it. Underwriting is automated: the response comes back with an approved amount, a rate, and a schedule rather than entering a queue. The rate you’re offered is a function of your loan-to-value ratio, not of the rate you request.requested_rate is an input to negotiation, not a setting.
Collateral is liquidated if your LTV breaches the maintenance threshold — the same mechanic as
any collateralized position. Posting volatile collateral at a high
ltv_ratio means a price move
can trigger liquidation before a repayment is ever late. Over-collateralize deliberately.Body
The borrower’s DID, e.g.
did:stateset:borrower:def456.What secures the loan. Multiple assets of mixed type may be posted together; each carries its own
LTV.
Show properties
Show properties
Response
What was approved. May be less than requested if collateral does not support the principal —
compare the two before drawing down.
Realised LTV across the whole position — principal ÷ collateral value. Watch this, not the
per-asset ratios.
Errors
Succeeds with201. Failures return 400, 401, 403, 422 or 429 with an error body, per the platform status-code contract.
curl -X POST 'https://api.stateset.com/v1/finance/loans/request' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
-d '{
"borrower_id": "did:stateset:borrower:def456",
"loan_amount": "25000.00",
"currency": "USDC",
"loan_purpose": "working_capital",
"term_months": 12,
"collateral": [
{
"type": "cryptocurrency",
"asset": "STATE",
"amount": "50000.00",
"current_value": "50000.00",
"ltv_ratio": 0.5
},
{
"type": "invoice",
"asset_id": "inv_78901",
"face_value": "15000.00",
"ltv_ratio": 0.8
}
],
"requested_rate": 0.08
}'
{
"loan_id": "loan_5z8nPq3oW7",
"status": "PENDING_APPROVAL",
"requested_amount": "25000.00",
"approved_amount": "25000.00",
"interest_rate": 0.075,
"term_months": 12,
"monthly_payment": "2256.50",
"total_collateral_value": "65000.00",
"ltv_ratio": 0.38,
"approval_time": "instant",
"funds_available": "2024-06-25T12:15:00Z"
}
Next
Approval does not move money. Draw the principal withPOST /v1/finance/loans/{loan_id}/drawdown, which returns the full repayment schedule — see
Finance.
Related
- Approve Loan
- Repay Loan
- Liquidate Loan
- Factor Invoice — sell a receivable instead of borrowing against it
Last modified on September 21, 2026