POST /quote), a signed quote the borrower can take, and indicative (POST /quote/indicative), an unsigned rate preview nothing can take.
Conventions
- Numerics are decimal strings, never JSON numbers.
"1000000", not1000000. The one exception ischainId, which is a number. - Addresses are EIP-55 checksummed. All-lowercase hex is also accepted and normalised to EIP-55 on ingress. The two rejected forms are mixed-case hex with an invalid checksum and all-caps hex.
- Rates and LLTVs are WAD (
1e18= 100%)."81000000000000000"is 8.1%. - Amounts are in the token’s own decimals. No implicit scaling.
- Times are seconds;
deadlineis a unix timestamp.
POST /quote
Submits a borrower intent and returns the best valid quote from the round.
Request body
venueBitmap is checked venue by venue, so a bit naming a venue with no market for the pair is rejected even when another named venue could serve it. Setting the Morpho Blue bit for a pair with no Morpho Blue market returns 400 with venueBitmap allows morphoBlue but no morphoBlue market exists for 0x…/0x…; clear that venue bit, whether or not another venue’s bit is also set. Clear the bit rather than relying on another venue to cover it.Response 200
The winning quote’s fields inline, plus allQuotes, every quote that survived validation in that round, the winner included.
quoteId is generated if the solver omitted it. Responses echo the caller’s origin in Access-Control-Allow-Origin when it is allowlisted, so only Iris’s own apps can read a response from a browser.
Errors
404 is a normal outcome, not a fault: it means every solver declined, timed out, or had its quote dropped in validation.
reasons collects the decline reasons solvers gave in their own 404 bodies (see Declining with reasons), with each venue and reason pair listed once across solvers. Where several solvers gave a rate for the same pair, the lowest one is kept, since that is the rate the borrower could get. It is an empty array when no solver gave a reason, so it does not account for solvers that timed out or had their quote dropped. errorCode and detail are unchanged, so callers that only check those keep working.
POST /quote/indicative
Returns a rate preview before the borrower has connected a wallet. The round runs like POST /quote, but only solvers whose registry entry sets an indicativeEndpoint are called, and they answer unsigned. Nothing this route returns can be submitted to Iris.take(): to borrow, request a firm quote from POST /quote.
Request body
ThePOST /quote body with borrower and receiver optional. When given, each must still be an EIP-55 address, non-zero. Every other field keeps its bounds, and the same request checks run before any solver is called: supported tokens, registered venues, and a market for the pair on every named venue.
Response 200
The winning quote’s terms inline, plus allQuotes, every indicative quote that survived validation. The shape is the POST /quote response with indicative: true added and without quoteId, deadline, nonce, signature or the permit2 pair.
Errors
The same asPOST /quote, including the edge 202, the origin 403, and the 404 with reasons when no solver returned a valid quote.
Solver webhook
What the coordinator POSTs to a registered solver’sendpoint.
Request
Identical to thePOST /quote body, plus a quoteId minted for this call. Each solver in a round receives a different quoteId and the same requestId.
Response
Return200 with the body below, or decline with 404 / bond: "0" (a 404 may say why, see Declining with reasons). The permit2 pair is optional together: omit both fields to fund the bond from your standing ERC-20 allowance to Iris, or supply both to stage the Permit2 fallback. Half a pair is rejected.
Signature construction is covered in Get Started; the checks these fields face are in Validation.
Declining with reasons
A404 decline may carry a body saying why you declined. The coordinator passes the reasons on to the borrower in its own 404 (see Errors).
The body is optional, and only a
404 is read for it; a bond: "0" decline carries no reasons. A list that breaks any bound is ignored as a whole, never treated as an error: the decline still counts as a decline.
Indicative requests
ForPOST /quote/indicative, the coordinator POSTs to your entry’s indicativeEndpoint instead, with the same headers, response budget and scoping filters as endpoint. Entries without an indicativeEndpoint are not called. The request is the indicative request body plus a quoteId; borrower and receiver are left out, not sent as null, when the caller gave none.
Return 200 with an unsigned quote, or decline exactly as for a firm request. The response takes the firm response’s fields from requestId to bond with the same bounds, leaves out deadline, nonce, signature and the permit2 pair, and adds one field:
solver still has to match your registered address, although nothing is signed. The coordinator does not read your balance or allowances for an indicative quote, so decline with a 404 when you could not fund the bond a firm quote would need, for example {"reasons": [{"venue": "solver", "reason": "insufficient_bond_balance"}]}.

