Skip to main content

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]

  • ]
  • asyncAlternatives object[]

    Solana only, present only when non-empty: routes that do NOT settle in the signed transaction (Nest RWA shares: USDC → share mints over CCTP → Plume → LayerZero; share → USDC queues Nest's async redemption). Never part of quotes[] and never ranked against it — a client must show settlement before offering one. See NEST_SOLANA.md.

  • Array [
  • aggregatorstringrequired

    Possible values: [Nest]

    actionstringrequired

    Possible values: [mint, redeem-request]

    atomicbooleanrequired

    Possible values: [false]

    tradeInputnumberrequired
    tradeOutputnumberrequired

    Indicative: priced when the deposit / redemption executes on Plume. No slippage bound applies.

    settlement objectrequired
    kindstringrequired

    Possible values: [async-crosschain]

    etaSecondsintegernullablerequired

    Indicative; null when an operator fulfils it (a redemption request).

    statusUrlstringrequired

    Replace {signature} with the Solana transaction signature.

    viastring[]
    fees object[]
  • Array [
  • assetstring
    amountstring

    Raw units

    kindstring
  • ]
  • notestring
    buildError object

    The quote stands but the issuer refused to build (e.g. OWNER_TOKEN_ACCOUNT_NOT_FOUND).

    codestring
    messagestring
    tx object

    Partially signed by Nest: add the wallet signature, never recompile the message.

    chainTypestring

    Possible values: [svm]

    transactionstring

    Base64 v0 transaction

    lastValidBlockHeightinteger
    partiallySignedboolean

    Possible values: [true]

  • ]
  • 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"
    }
    ],
    "asyncAlternatives": [
    {
    "aggregator": "Nest",
    "action": "mint",
    "atomic": false,
    "tradeInput": 0,
    "tradeOutput": 0,
    "settlement": {
    "kind": "async-crosschain",
    "etaSeconds": 0,
    "statusUrl": "string",
    "via": [
    "string"
    ]
    },
    "fees": [
    {
    "asset": "string",
    "amount": "string",
    "kind": "string"
    }
    ],
    "note": "string",
    "buildError": {
    "code": "string",
    "message": "string"
    },
    "tx": {
    "chainType": "svm",
    "transaction": "string",
    "lastValidBlockHeight": 0,
    "partiallySigned": true
    }
    }
    ]
    }