Request Loan

Borrow against posted collateral — crypto, invoices, or inventory — with instant underwriting.

POST /v1/finance/loans/request

cURL

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
  }'

200

{
  "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

borrower_id · string · required

The borrower’s DID, e.g. did:stateset:borrower:def456.

loan_amount · string · required

Principal requested, as a decimal string.

currency · string · required

USDC or ssUSD.

loan_purpose · string · required

Use of funds, e.g. working_capital. Feeds underwriting.

term_months · number · required

Term in months.

collateral · array · required

What secures the loan. Multiple assets of mixed type may be posted together; each carries its own LTV.

Show properties

type · string · required

cryptocurrency, invoice, or inventory.

asset · string

Ticker, for cryptocurrency collateral — e.g. STATE.

asset_id · string

Identifier, for asset-backed collateral — e.g. an invoice ID.

amount · string

Quantity posted, for fungible collateral.

current_value · string

Mark-to-market value.

face_value · string

Face value, for invoice collateral.

ltv_ratio · 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.

requested_rate · number

Your target annual rate as a decimal — 0.08 is 8%. Indicative only.

Response

loan_id · string · required

Identifier for the loan.

status · string · required

PENDING_APPROVAL, APPROVED, ACTIVE, REPAID, or LIQUIDATED.

requested_amount · string · required

What you asked for.

approved_amount · string · required

What was approved. May be less than requested if collateral does not support the principal — compare the two before drawing down.

interest_rate · number · required

The rate actually applied.

term_months · number · required

Approved term.

monthly_payment · string · required

Scheduled payment.

total_collateral_value · string · required

Aggregate mark-to-market value of everything posted.

ltv_ratio · number · required

Realised LTV across the whole position — principal ÷ collateral value. Watch this, not the per-asset ratios.

approval_time · string · required

How long underwriting took, e.g. instant.

funds_available · string · required

When the principal can be drawn.

cURL

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
  }'

200

{
  "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 with POST /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