v1

latestOpenAPI 3.1.02026-07-22163829.6 KB

Trading

Commit to Quote

Commit to the best valid quote. The relay selects the winner, builds the EIP-712 Order, asks the winning maker to sign it (over the post-trade WebSocket, confirmed via REST), and returns the signed order plus the single USDC approval the taker must make before calling fill(). Blocks until a maker confirms; falls back to the next-best maker on a missed deadline. Returns a simulated execution when the on-chain environment is not configured.

post/quote-requests/{id}/commit

Path parameters

idstring required

Example:req-789

The requestId returned by Create Quote Request.

Request body

walletstring required

Taker wallet (checksummed). Set as taker in the order — only this wallet can call fill().

Example request

{
  "wallet": "0xTrader0000000000000000000000000000000000"
}

Response

Order signed by the winning maker (or simulated execution)

successtrue

messagestring

mode'onchain' | 'simulated'

Example response

{
  "message": "Order signed by maker — call fill() on-chain",
  "mode": "onchain",
  "quote": {
    "maker_id": "mm-alpha",
    "quote_id": "8f3c2b1a-1d2e-4c3b-9a8f-6e5d4c3b2a1f",
    "maker": "0x1234000000000000000000000000000000abcd",
    "side": "buy",
    "price": 0.12,
    "size": 10,
    "expires_in_ms": 5000
  },
  "execution": {
    "execution_id": "e1f2a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6b",
    "request_id": "req-789",
    "quote_id": "8f3c2b1a-1d2e-4c3b-9a8f-6e5d4c3b2a1f",
    "maker_id": "mm-alpha",
    "executed_at": "2026-06-15T12:00:01.234Z"
  },
  "onchain": {
    "settlementAddress": "0x3E583BC44157c91F8c534372A3e91c371841107A",
    "coreAddress": "0x76c41a03e0993F0261bB3B1949320cA693f76faE",
    "order": {
      "maker": "0x1234000000000000000000000000000000abcd",
      "seriesId": "98765432109876543210",
      "optionAmount": "10000000",
      "premiumAmount": "1200000",
      "makerSelling": true,
      "taker": "0xTrader0000000000000000000000000000000000",
      "validUntil": 1717189320,
      "nonce": 1717189200042
    },
    "makerSignature": "0xabcdef...",
    "domain": {
      "name": "ConvallaxRFQSettlement",
      "version": "1",
      "chainId": 80002,
      "verifyingContract": "0x3E583BC44157c91F8c534372A3e91c371841107A"
    },
    "chainId": 80002,
    "takerApproval": {
      "spender": "0x3E583BC44157c91F8c534372A3e91c371841107A",
      "amount": "1200000",
      "reason": "premium"
    }
  }
}