Build

Assemble a quoted swap into an executable transaction

Assemble a quote into an executable transaction

post

Takes a quote_id from a previous /v1/quote response and assembles it into an unsigned transaction ready for wallet signing and on-chain submission. This is the second step in the swap flow: quote -> build -> execute (or submit directly).

The response contains a complete transaction object (to, data, value, gas, chain_id) targeting the ExecutionProxy contract, plus estimated output metadata.

Quotes can be built multiple times (no consumption on build). An optional permit2_signature can be attached for gasless approval flows.

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication. Can also be provided via Authorization header with Bearer prefix: Authorization: Bearer <api-key>

Body

application/json

quote_idstringRequired

Quote identifier from a previous /v1/quote response

Example: 550e8400-e29b-41d4-a716-446655440000

permit2_signaturestringOptional

Hex-encoded Permit2 signature from signing the EIP-712 typed data returned in the quote's permit2 field. Only used if the original quote was requested with include_permit2=true. Silently ignored if the quote did not include permit2 data.

Example: 0x1234567890abcdef...Pattern: ^0x[a-fA-F0-9]+$

simulatebooleanOptional

Run fork simulation on the assembled transaction before returning. The simulation result is included in the response. Simulation failures do NOT block the response — the transaction is still returned with simulation.success=false.

Default: false

Responses

200

Transaction assembled successfully

application/json

400

Bad request - missing quote_id or invalid JSON

application/json

401

Unauthorized - missing or invalid API key

application/json

404

Quote not found

application/json

500

Internal server error - assembly failed

application/json

post

/v1/build

HTTPcURLJavaScriptPython

POST /v1/build HTTP/1.1
Host: api.infraredtrading.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "quote_id": "550e8400-e29b-41d4-a716-446655440000"
}

Basic build from quoteBuild with Permit2 signatureBuild with fork simulation

{
  "data": {
    "transaction": {
      "to": "0x1111111111111111111111111111111111111111",
      "data": "0x5ca02d52000000000000000000000000...",
      "value": "0",
      "gas": 250000,
      "chain_id": 1
    },
    "estimated_outputs": [
      {
        "token": "0x6B175474E89094C44Da98b954EedeBC836211103",
        "chain_id": 1,
        "expected_amount": "1850000000000000000000",
        "minimum_amount": "1831500000000000000000"
      }
    ]
  }
}