Skip to main content
POST
Create Loan Request
Creates a loan request on a market that runs approve-only loans. Leave loanId out to ask for a new loan. Name an open loan of the borrower in loanId to ask for an additional draw. Limits and replacement are per instance:
  • A new request for the same wallet and loan replaces your instance’s own waiting request. The answer names the replaced request in replaced.
  • Your instance keeps at most 3 waiting requests per wallet and 25 per market. Beyond that the route answers 429 LOAN_REQUEST_LIMIT. Only REQUESTED requests count, and the one being replaced does not.
  • Requests by different instances for the same wallet do not block each other.
The routes carry no personal data fields. Send wallet addresses, amounts and externalReference only.

Path Parameters

string
required
The market’s record ID on your instance.

Body Parameters

string
required
The wallet that will borrow.
string | number
required
The amount to borrow.
string | number
The collateral amount.
string | number | null
Leave out for a new loan. Name an open loan of that borrower to request an additional draw.
string | null
Your own case or file number: 1 to 64 letters, digits, dots, underscores or hyphens. No personal data.

Response Fields

Answers 201.
object

Error Codes