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"
}
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
string
required
Principal requested, as a decimal string.
string
required
USDC or ssUSD.string
required
Use of funds, e.g.
working_capital. Feeds underwriting.number
required
Term in months.
array
required
What secures the loan. Multiple assets of mixed type may be posted together; each carries its own
LTV.
Show properties
Show properties
string
required
cryptocurrency, invoice, or inventory.string
Ticker, for
cryptocurrency collateral — e.g. STATE.string
Identifier, for asset-backed collateral — e.g. an invoice ID.
string
Quantity posted, for fungible collateral.
string
Mark-to-market value.
string
Face value, for invoice collateral.
number
Advance rate against this asset —
0.5 lends 50% of its value. Liquid crypto carries a lower
LTV than a receivable from an investment-grade buyer.number
Your target annual rate as a decimal —
0.08 is 8%. Indicative only.Response
string
required
Identifier for the loan.
string
required
PENDING_APPROVAL, APPROVED, ACTIVE, REPAID, or LIQUIDATED.string
required
What you asked for.
string
required
What was approved. May be less than requested if collateral does not support the principal —
compare the two before drawing down.
number
required
The rate actually applied.
number
required
Approved term.
string
required
Scheduled payment.
string
required
Aggregate mark-to-market value of everything posted.
number
required
Realised LTV across the whole position — principal ÷ collateral value. Watch this, not the
per-asset ratios.
string
required
How long underwriting took, e.g.
instant.string
required
When the principal can be drawn.
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 August 29, 2026