Request a swap quote

Flag indicating whether this is a dry run request. If true, the response will NOT contain the following fields:

• depositAddress
• timeWhenInactive
• deadline

How to interpret amount (and refunds) when performing the swap:

• EXACT_INPUT — requests the output amount for an exact input.

  • If deposit is less than amountIn, the deposit is refunded by deadline.
  • If deposit is above than amountIn, the swap is processed and the excess is refunded to refundTo address after swap is complete.

• EXACT_OUTPUT — requests the input amount for an exact output.

  • The quote response would have two fields minAmountIn and maxAmountIn.
  • If the input is above than maxAmountIn the swap is processed and the excess is refunded to refundTo address after swap is complete.
  • If the input is less than minAmountIn, the deposit is refunded by deadline.

• FLEX_INPUT — a flexible input amount that allows for partial deposits and variable amounts.

  • slippage applies both to amountOut and amountIn and defines an acceptable range (minAmountIn and minAmountOut).
  • Any amount higher than minAmountIn is accepted and converted to the output asset as long as minAmountOut is met.
  • The amountIn can be less, as long as the 'slippage + 1%' constraint is met. If the total received by the deadline is below the lower bound, the deposit is refunded.
  • If deposits exceed the upper bound, the swap is still processed

Slippage tolerance for the swap. This value is in basis points (1/100th of a percent), e.g. 100 for 1% slippage.

ID of the origin asset.

Type of deposit address:

• ORIGIN_CHAIN - deposit address on the origin chain.
• INTENTS - the account ID within NEAR Intents to which you should transfer assets.

ID of the destination asset.

Amount to swap as the base amount. It is interpreted as the input or output amount based on the swapType flag and is specified in the smallest unit of the currency (e.g., wei for ETH).

Address used for refunds.

Type of refund address:

• ORIGIN_CHAIN - assets are refunded to the refundTo address on the origin chain.
• INTENTS - assets are refunded to the refundTo Intents account.

Recipient address. The format must match recipientType.

Type of recipient address:

• DESTINATION_CHAIN - assets are transferred to the chain of destinationAsset.
• INTENTS - assets are transferred to an account inside Intents

Timestamp in ISO format that identifies when the user refund begins if the swap isn't completed by then. It must exceed the time required for the deposit transaction to be mined. For example, Bitcoin may require around one hour depending on the fees paid.

What deposit address mode you will get in the response, most chain supports only SIMPLE and some(for example stellar) only MEMO:

• SIMPLE - usual deposit with only deposit address.
• MEMO - some chains will REQUIRE the memo together with depositAddress for swap to work.

Unique client session identifier for 1Click.

EVM address of a transfer recipient in a virtual chain

EVM address of a refund recipient in a virtual chain

HIGHLY EXPERIMENTAL Message to pass to ft_transfer_call when withdrawing assets to NEAR.

Otherwise, ft_transfer will be used.

WARNING: Funds will be lost if used with non NEP-141 tokens, in case of insufficient storage_deposit or if the recipient does not implement ft_on_transfer method.

Referral identifier (lowercase only). It will be reflected in the on-chain data and displayed on public analytics platforms.

Time in milliseconds the user is willing to wait for a quote from the relay. If you want to receive the fastest quote - use 0 as a value

Unique identifier for request tracing and debugging

Timestamp in ISO format that was used to derive the deposit address

Signature of the 1Click service confirming the quote for the specific deposit address. Must be saved on the client side (along with the whole quote) in order to resolve any disputes or mistakes.