--- title: "POST /quote/v2" method: POST path: "/quote/v2" --- # POST /quote/v2 `POST /quote/v2` ## Headers - `x-api-key` string ## Request body - object - `user` string, required — Address that is depositing funds on the origin chain and submitting transactions or signatures - `recipient` string — Address that is receiving the funds on the destination chain, if not specified then this will default to the user address - `originChainId` number, required - `destinationChainId` number, required - `originCurrency` string, required - `destinationCurrency` string, required - `amount` string, required — Amount to swap as the base amount (can be switched to exact input/output using the dedicated flag), denoted in the smallest unit of the specified currency (e.g., wei for ETH) - `tradeType` 'EXACT_INPUT' | 'EXACT_OUTPUT' | 'EXPECTED_OUTPUT', required — Whether to use the amount as the output or the input for the basis of the swap - `txs` object[] - `to` string - `value` string - `data` string - `originalTxValue` string - `txsGasLimit` number — Total gas limit for the destination chain call transactions - `authorizationList` object[] — Authorization list for EIP-7702 transactions to be executed on destination chain - `chainId` number, required - `address` string, required - `nonce` number, required - `yParity` number, required - `r` string, required - `s` string, required - `additionalData` object — Additional data needed for specific routes - `userPublicKey` string — If the request originates from Bitcoin and the user is a P2SH address, the public key is needed to be able to generate the transaction data - `referrer` string - `referrerAddress` string - `refundTo` string — Address to send the refund to in the case of failure, if not specified then the recipient address or user address is used - `recoveryAddress` string — Origin-chain address used for deposit-address fund recovery. Requires useDepositAddress=true. - `refundOnOrigin` boolean — Always refund on the origin chain in case of any issues - `topupGas` boolean — If set, the destination fill will include a gas topup to the recipient (only supported for EVM chains if the requested currency is not the gas currency on the destination chain) - `topupGasAmount` string — The destination gas topup amount in USD decimal format, e.g 100000 = $1. topupGas is required to be enabled. Defaults to 2000000 ($2) - `enableTrueExactOutput` boolean — Enabling will send any swap surplus when doing exact output operations to the solver EOA, otherwise it will be swept to the recipient - `explicitDeposit` boolean — Enable this to avoid direct transfers to the depository (only relevant for EVM and v2 protocol flow) - `useExternalLiquidity` boolean — Enable this to use canonical+ bridging, trading speed for more liquidity - `useFallbacks` boolean — Enable this for specific fallback routes - `usePermit` boolean — Enable this to use permit (eip3009) when bridging, only works on supported currency such as usdc - `permitExpiry` number — How long the permit remains valid, in seconds. Defaults to 10 minutes. - `includeProtocolData` boolean — Return protocol data for on-chain intent validation. This includes protocol.v2.orderSignature and may increase quote latency. - `useDepositAddress` boolean — Enable this to use a deposit address when bridging, in scenarios where calldata cannot be sent alongside the transaction. only works on native currency bridges. For new requests, EXACT_OUTPUT is only supported when strict is also enabled. - `strict` boolean — When used with useDepositAddress, enables a strict deposit address that is tied to a specific order. Underpayments fail and refund, exact payments fill, and overpayments fill the quoted amount while refunding the excess in a separate refund leg. EXACT_OUTPUT deposit-address requests are only supported in strict mode. Open-ended deposit addresses remain the flexible path for variable deposited amounts. Requires a refundTo address. - `slippageTolerance` string — Slippage tolerance for the swap, if not specified then the slippage tolerance is automatically calculated to avoid front-running. This value is in basis points (1/100th of a percent), e.g. 50 for 0.5% slippage. Must be 0–10000 bps. - `latePaymentSlippageTolerance` string — Slippage tolerance for destination gas in the event that the deposit occurs after the order deadline, and more gas is required for the solver to execute the destination transaction. Must be 0–10000 bps. - `appFees` object[] - `recipient` string — Address that will receive the app fee - `fee` string — App fees to be charged for execution in basis points, e.g. 100 = 1% - `gasLimitForDepositSpecifiedTxs` number — If the request involves specifying transactions to be executed during the deposit transaction, an explicit gas limit must be set when requesting the quote - `forceSolverExecution` boolean — Force executing swap requests via the solver (by default, same-chain swap requests are self-executed) - `subsidizeFees` boolean — If the sponsor should pay for the fees associated with the request. Includes gas topup amounts. - `sponsoredFeeComponents` string[] — The fee components to sponsor for swap execution kinds. Requires subsidizeFees=true. Defaults to execution, swap, relay, and app when omitted; rent remains user-paid unless explicitly selected. - `maxSubsidizationAmount` string — The max subsidization amount in USDC decimal format, e.g 1000000 = $1. subsidizeFees must be enabled. The sponsor will cover fees up to this cap and the user pays any remainder. - `subsidizeRent` boolean — Deprecated compatibility alias that adds "rent" to sponsoredFeeComponents. - `includedSwapSources` string[] — Swap sources to include for swap routing. - `excludedSwapSources` string[] — Swap sources to exclude for swap routing. - `includedOriginSwapSources` string[] — Swap sources to include for swap routing on origin. - `includedDestinationSwapSources` string[] — Swap sources to include for swap routing on destination. - `originGasOverhead` number — The gas overhead for the origin chain, this is used to calculate the gas fee for the origin chain when the solver is executing a gasless transaction on the origin chain - `depositFeePayer` string — The payer to be set for deposit transactions on solana. This account must have enough for fees and rent. - `maxRouteLength` number — Maximum number of hops to use in solana swap routing. Can reduce transaction size. - `useSharedAccounts` boolean — Prevents certain ATA creation instructions in solana routing - `includeComputeUnitLimit` boolean — Whether to include compute unit limit instruction for solana origin requests. - `overridePriceImpact` boolean — Whether to ignore price impact errors. - `disableSwapProviderPreference` boolean — Whether to disable preferred swap provider selection. - `disableOriginSwaps` boolean — Whether to disable origin swaps. - `fixedRate` string — The rate to charge for fixed spread quotes. - `ttl` number — Time-to-live for the quote, in seconds, measured from when the quote was generated. If the request is not filled within this window it is refunded instead of filled. ## Response `200` Default Response - object - `steps` object[] — An array of steps detailing what needs to be done to bridge, steps includes multiple items of the same kind (signature, transaction, etc) - `id` 'deposit' | 'approve' | 'authorize' | 'authorize1' | 'authorize2' | 'swap' | 'send', required — Unique identifier tied to the step - `action` string, required — A call to action for the step - `description` string, required — A short description of the step and what it entails - `kind` string, required — The kind of step, can either be a transaction or a signature. Transaction steps require submitting a transaction while signature steps require submitting a signature - `requestId` string — A unique identifier for this step, tying all related transactions together - `depositAddress` string — The deposit address for the bridge request - `items` object[], required — While uncommon it is possible for steps to contain multiple items of the same kind (transaction/signature) grouped together that can be executed simultaneously. - `status` string — Can either be complete or incomplete, this can be locally controlled once the step item is completed (depending on the kind) and the check object (if returned) has been verified. Once all step items are complete, the bridge is complete - `data` unknown - `check` object — Details an endpoint and a method you should poll to get confirmation, the endpoint should return a boolean success flag which can be used to determine if the step item is complete - `endpoint` string — The endpoint to confirm that the step item was successfully completed - `method` string — The REST method to access the endpoint - `fees` object - `gas` object — Origin chain gas fee - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `relayer` object — Combination of the relayerGas and relayerService to give you the full relayer fee - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `relayerGas` object — Destination chain gas fee - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `relayerService` object — Fees paid to the relay solver, note that this value can be negative (which represents network rewards for moving in a direction that optimizes liquidity distribution) - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `app` object — Fees paid to the app. Currency will be the same as the relayer fee currency. This needs to be claimed later by the app owner and is not immediately distributed to the app - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `subsidized` object — The amount of fees for the request that are subsidized by the request sponsor. Does not include deposit origin gas unless it is a permit based deposit. - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `feeSponsorship` object — Granular fee sponsorship details derived from the solver's internal sponsorship resolution. - `quoted` object — The quote-time sponsorship expectation for the request. - `selectedComponents` string[], required — The normalized sponsorship buckets selected for this request. - `maxSubsidizationAmount` string — The requested sponsorship cap in USD micro-units, when one was configured for the request. - `capHit` boolean, required — Whether the configured sponsorship cap limited the selected fee buckets for this phase. - `components` object, required — Per-bucket sponsorship details for the sponsorable fee components. - `execution` object, required — Execution fee sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `swap` object, required — Swap fee sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `relay` object, required — Relay protocol fee sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `app` object, required — App fee sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `rent` object, required — Solana ATA rent sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsoredTotal` object, required — The total amount sponsored for this phase. - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPaysTotal` object, required — The total amount the user paid across the sponsorable fee buckets for this phase. - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `actual` object — The post-solve sponsorship outcome recorded for the request. - `selectedComponents` string[], required — The normalized sponsorship buckets selected for this request. - `maxSubsidizationAmount` string — The requested sponsorship cap in USD micro-units, when one was configured for the request. - `capHit` boolean, required — Whether the configured sponsorship cap limited the selected fee buckets for this phase. - `components` object, required — Per-bucket sponsorship details for the sponsorable fee components. - `execution` object, required — Execution fee sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `swap` object, required — Swap fee sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `relay` object, required — Relay protocol fee sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `app` object, required — App fee sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `rent` object, required — Solana ATA rent sponsorship details. - `selected` boolean, required — Whether this fee bucket was selected for sponsorship. - `total` object, required — The full amount charged for this fee bucket. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsored` object, required — The portion of this fee bucket covered by the sponsor. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPays` object, required — The portion of this fee bucket that remained user-paid. - `currency` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsoredTotal` object, required — The total amount sponsored for this phase. - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `userPaysTotal` object, required — The total amount the user paid across the sponsorable fee buckets for this phase. - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `sponsorPayment` object — How much the sponsor ultimately paid, denominated in the sponsor payment currency. - `amount` string, required — The sponsor payment amount. - `address` string, required — The sponsor payment currency address. - `chainId` number, required — The sponsor payment chain id. - `details` object — A summary of the swap and what the user should expect to happen given an input - `operation` string — The operation that will be performed, possible options are send, swap, wrap, unwrap, bridge - `sender` string — The address that deposited the funds - `recipient` string — The address that will be receiving the swap output - `currencyIn` object - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `currencyOut` object - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `refundCurrency` object - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `currencyGasTopup` object - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - `logoURI` string - `verified` boolean - `isNative` boolean - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `totalImpact` object — The difference between the input and output values, including fees - `usd` string - `percent` string - `swapImpact` object — The impact of the swap, not factoring in fees - `usd` string - `percent` string - `expandedPriceImpact` object - `swap` object — Cost to execute swap or bridge depending on available liquidity. This value can be negative (representing network rewards for improving liquidity distribution) - `usd` string - `execution` object — Fees paid to cover transaction execution costs - `usd` string - `relay` object — Fees paid to the protocol - `usd` string - `app` object — Fees paid to the app. Currency will be the same as the relayer fee currency. This needs to be claimed later by the app owner and is not immediately distributed to the app - `usd` string - `sponsored` object — Fees paid by a sponsor for this request - `usd` string - `rate` string — The swap rate which is equal to 1 input unit in the output unit, e.g. 1 USDC -> x ETH. This value can fluctuate based on gas and fees. - `slippageTolerance` object - `total` string — The total slippage tolerance applied to the order, in basis points (1/100th of a percent), e.g. 50 for 0.5% slippage. The origin and destination breakdowns are alternative allocations of this budget and are not additive. - `origin` object — The slippage tolerance on the origin chain swap - `usd` string - `value` string - `percent` string - `destination` object — The slippage tolerance on the destination chain swap - `usd` string - `value` string - `percent` string - `timeEstimate` number — Estimated swap time in seconds - `userBalance` string — The user's balance in the given currency on the origin chain - `fallbackType` string — The type of fallback route the request uses, if any - `isFixedRate` boolean — Whether the rate for the quote is fixed or dynamic (swap on origin/destination) - `fixedRateFee` object — The USD cost of the fixed rate vs market rate. Positive means the fixed rate is worse than market (user pays premium), negative means better (user benefits). Only present for fixed rate quotes. - `usd` string - `route` object - `origin` object — The route taken for the origin chain swap - `inputCurrency` object - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `outputCurrency` object - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `router` string - `includedSwapSources` string[] - `destination` object — The route taken for the origin chain swap - `inputCurrency` object - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `outputCurrency` object - `currency` object - `chainId` number - `address` string - `symbol` string - `name` string - `decimals` number - `metadata` object - … - `amount` string - `amountFormatted` string - `amountUsd` string - `minimumAmount` string - `router` string - `includedSwapSources` string[] - `protocol` object — Protocol information for the quote - `v2` object - `orderId` string — The underlying protocol order id - `hubType` 'onchain' — The protocol hub type. Always 'onchain' for the public protocol contract. Mirrors the requests/v3 protocol block. - `orderData` unknown - `orderSignature` string — Solver's ECDSA signature over the orderId, returned when includeProtocolData is set. Use ecrecover to verify the commitment on-chain. - `paymentDetails` object — The details for the depository payment - `chainId` string — The protocol chain id for the payment - `depository` string — The depository address - `currency` string — The currency of the payment - `amount` string — The amount of the payment ## Other responses - `400` — Default Response - `401` — Default Response - `429` — Default Response - `500` — Default Response --- [API](https://skmtc.net/relay/apis/cross-chain-solver.md) · [All operations](https://skmtc.net/relay/apis/cross-chain-solver/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/relay/cross-chain-solver/versions/428d669c2830/schema)