SpotBuildResponse

Full build response for spot swap (account provided).

currencyIn objectrequired

Input currency info

property name*any

Input currency info

currencyOut objectrequired

Output currency info

property name*any

Output currency info

quotes object[]required

Candidate routes, best output first. Execute exactly one.

Array [

aggregatorstring

tradeInputnumber

tradeOutputnumber

tx object

An EVM transaction ready to sign and broadcast. Send to, data and value as-is; do not re-encode them.

chainTypestring

Which VM executes this step. ABSENT means evm, which is the only value any endpoint returns today — every EVM response is unchanged. A non-EVM chain would return a different shape (a serialized, PERISHABLE transaction rather than to/data/value) carrying its own chainType, so a client that wants to stay forward-compatible should branch on this field rather than assume to is present.

Possible values: [evm]

tostringrequired

Target contract address

Example: 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2

datastringrequired

Encoded calldata

Example: 0x617ba037000000000000000000000000c02aaa39b2

valuestringrequired

ETH value to send with the transaction

Example: 0

descriptionstring

Human-readable label. For alternatives, this is the aggregator name (e.g. "Paraswap"). For transactions, describes the setup action (e.g. "Switch e-mode to 1").

buildIdstring

Present when permit=auto|required produced a signature offer. Send it back in the POST body (builds[]) together with the signed permit to splice this exact build — no re-quote. Expires after ~3 minutes.

]

permissionTxns object[]required

Approvals needed for this specific quote. Most integrators should use the deduplicated envelope-level actions.permissions instead.

Array [

tostringrequired

Target contract address

datastringrequired

Encoded calldata

valuestringrequired

ETH value

Example: 0

descriptionstring

Human-readable description of the approval (e.g. "Approve borrow for AAVE_V3", "Approve ERC20")

spenderstring

ERC-20 approve spender (x-chain permissions). Match it against the selected quote's approvalTarget — several bridges can share one spender, so do not match by description.

typestring

What kind of grant this is. A signatures[] offer names the type it replaces via its replaces field.

Possible values: [ERC20, Lender]

]

SpotBuildResponse

{
  "currencyIn": {},
  "currencyOut": {},
  "quotes": [
    {
      "aggregator": "string",
      "tradeInput": 0,
      "tradeOutput": 0,
      "tx": {
        "chainType": "evm",
        "to": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
        "data": "0x617ba037000000000000000000000000c02aaa39b2",
        "value": "0",
        "description": "string"
      },
      "buildId": "string"
    }
  ],
  "permissionTxns": [
    {
      "to": "string",
      "data": "string",
      "value": "0",
      "description": "string",
      "spender": "string",
      "type": "ERC20"
    }
  ]
}