SpotBuildResponse
Full build response for spot swap (account provided).
currencyIn objectrequired
Input currency info
Input currency info
currencyOut objectrequired
Output currency info
Output currency info
quotes object[]required
Candidate routes, best output first. Execute exactly one.
tx object
An EVM transaction ready to sign and broadcast. Send to, data and value as-is; do not re-encode them.
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]
Target contract address
0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2Encoded calldata
0x617ba037000000000000000000000000c02aaa39b2ETH value to send with the transaction
0Human-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").
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.
Target contract address
Encoded calldata
ETH value
0Human-readable description of the approval (e.g. "Approve borrow for AAVE_V3", "Approve ERC20")
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.
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.
Possible values: [Nest]
Possible values: [mint, redeem-request]
Possible values: [false]
Indicative: priced when the deposit / redemption executes on Plume. No slippage bound applies.
settlement objectrequired
Possible values: [async-crosschain]
Indicative; null when an operator fulfils it (a redemption request).
Replace {signature} with the Solana transaction signature.
fees object[]
Raw units
buildError object
The quote stands but the issuer refused to build (e.g. OWNER_TOKEN_ACCOUNT_NOT_FOUND).
tx object
Partially signed by Nest: add the wallet signature, never recompile the message.
Possible values: [svm]
Base64 v0 transaction
Possible values: [true]
{
"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
}
}
]
}