Request a quote

POST /v1/quotes

Run a solver auction for a deposit intent and return the winning allocation together with the unsigned EIP-7702 settlement payload. Sign the authorization (chainId, address, nonce) with your EOA key and sign the executeDigest, then submit both to the deposits endpoint before the quote expires. Quotes are single-use and expire at expiresAt (Unix seconds).

Authentication

Send your API key in the api-key header.

Request body (application/json)

{
  "userAddress": "0x7c3bd8a1f0a4d1a707f3b8f2eab6a95cbe8f1a3d",
  "chain": 84532,
  "asset": "0x81ab7e0d570b01411fcefcbbcd7de70890a5dd15",
  "amount": "25000000",
  "riskTier": "balanced",
  "minApyBps": 300
}

Responses

Status	Description
200	The winning bid and the settlement payload to sign.
400	Invalid request. Possible codes: USER_003 (invalid userAddress), VALIDATION_001 (malformed asset address or non-integer amount).
404	No solver returned a bid for this intent (RESOURCE_001) — for example, no healthy venue matches the chain, asset, risk tier, or minApyBps constraints.
500	Server-side failure. Possible codes: SYSTEM_002 (no settlement delegate configured for the chain), SYSTEM_001 (storage failure).

200 response

{
  "success": true,
  "data": {
    "quoteId": "6884f0c2a9b1d43e2c7a9f10",
    "netApy": 4.7,
    "grossApy": 5.0,
    "feeBps": 30,
    "allocation": [
      {
        "venueId": "mockvault-84532",
        "vault": "0x9d4454b023096f34b160d6b654540c56a1f81688",
        "shareBps": 10000
      }
    ],
    "solverId": "house-4626",
    "riskScore": 0.25,
    "txPayload": {
      "authorization": {
        "chainId": 84532,
        "address": "0x5fbdb2315678afecb367f032d93f642f64180aa3",
        "nonce": 7
      },
      "executeDigest": "0x3f2a9c1d8e5b4a706f9d2c1b8a3e5d4c7b6a9f8e1d2c3b4a5f6e7d8c9b0a1f2e",
      "calls": [
        {
          "target": "0x81ab7e0d570b01411fcefcbbcd7de70890a5dd15",
          "value": "0",
          "data": "0x095ea7b30000000000000000000000009d4454b023096f34b160d6b654540c56a1f8168800000000000000000000000000000000000000000000000000000000017d7840"
        },
        {
          "target": "0x9d4454b023096f34b160d6b654540c56a1f81688",
          "value": "0",
          "data": "0x6e553f650000000000000000000000000000000000000000000000000000000001406f400000000000000000000000007c3bd8a1f0a4d1a707f3b8f2eab6a95cbe8f1a3d"
        }
      ],
      "executeNonce": "0"
    },
    "expiresAt": 1785283500
  },
  "timestamp": "2026-07-29T10:15:32.123Z"
}

400 response

{
  "success": false,
  "error": {
    "code": "VALIDATION_001",
    "message": "amount must be integer string",
    "category": "VALIDATION",
    "traceId": "a1b2c3d4e5f60718"
  },
  "timestamp": "2026-07-29T10:15:32.123Z"
}

404 response

{
  "success": false,
  "error": {
    "code": "RESOURCE_001",
    "message": "no solver bid for this intent",
    "category": "RESOURCE",
    "traceId": "a1b2c3d4e5f60718"
  },
  "timestamp": "2026-07-29T10:15:32.123Z"
}

500 response

{
  "success": false,
  "error": {
    "code": "SYSTEM_002",
    "message": "no delegate configured for chain",
    "category": "SYSTEM",
    "traceId": "a1b2c3d4e5f60718"
  },
  "timestamp": "2026-07-29T10:15:32.123Z"
}