Skip to main content
POST
Prepare a builder swap
Authentication · Builder integration

Authorizations

x-api-key
string
header
required

Server-side key created in an authenticated developer workspace. Builder codes are public attribution, not credentials.

Body

application/json
quoteId
string
required

Response

Successful response

quoteId
string
required
builderCode
string
required

Public, case-sensitive registered attribution code. May differ from the API key workspace. Omitted: use the key workspace code.

Pattern: ^[A-Za-z0-9_-]{3,32}$
amountOut
string
required
Pattern: ^[0-9]+$
minimumAmountOut
string
required
Pattern: ^[0-9]+$
fees
object
required
expiresAt
integer
required
settlementAvailable
boolean
required
chainId
integer
payer
string
Pattern: ^0x[0-9a-fA-F]{40}$
recipient
string
Pattern: ^0x[0-9a-fA-F]{40}$
tokenIn
string
Pattern: ^0x[0-9a-fA-F]{40}$
tokenOut
string
Pattern: ^0x[0-9a-fA-F]{40}$
amountIn
string
Pattern: ^[0-9]+$
grossAmountOut
string
Pattern: ^[0-9]+$
routeFee
string
Pattern: ^[0-9]+$
builderFee
string
Pattern: ^[0-9]+$
policySource
enum<string>
Available options:
onchain,
local-preview
registry
string | null
provider
string
routes
object[]
warnings
string[]
transaction
object
approval
object | null
gas
string
Pattern: ^[0-9]+$
simulation
object
review
string