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.

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").

]

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.

]

SpotBuildResponse

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