GET_NEAR_SWAP_FULL_QUOTE
Obtain a full quote and a unique deposit address to initiate a NEAR intent swap. Requires recipient and refund addresses to proceed with the exchange.
Instructions
[STEP 2] Get a full quote with deposit address for a NEAR intent swap. This requires recipient and refund addresses and returns a unique deposit address where users can send their funds to initiate the swap. Use this when users are ready to proceed with the swap after checking the simple quote. NOTE: If users provide simple token names (e.g., 'ETH', 'USDC'), first use GET_NEAR_SWAP_TOKENS to discover the exact token IDs required for this API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| swapType | No | (Optional, defaults to EXACT_INPUT) Whether to use the amount as the output or the input for the basis of the swap: EXACT_INPUT - request output amount for exact input, EXACT_OUTPUT - request output amount for exact output. The refundTo address will always receive excess tokens back even after the swap is complete. | EXACT_INPUT |
| originAsset | Yes | ID of the origin asset (e.g. 'nep141:arb-0xaf88d065e77c8cc2239327c5edb3a432268e5831.omft.near') | |
| destinationAsset | Yes | ID of the destination asset (e.g. 'nep141:sol-5ce3bf3a31af18be40ba30f721101b4341690186.omft.near') | |
| amount | Yes | 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) | |
| recipient | Yes | Recipient address. The format should match recipientType. | |
| recipientType | No | (Optional, defaults to DESTINATION_CHAIN) Type of recipient address: DESTINATION_CHAIN - assets will be transferred to chain of destinationAsset, INTENTS - assets will be transferred to account inside intents | DESTINATION_CHAIN |
| refundTo | No | (Optional) Address for user refund | |
| refundType | No | (Optional, defaults to ORIGIN_CHAIN) Type of refund address: ORIGIN_CHAIN - assets will be refunded to refundTo address on the origin chain, INTENTS - assets will be refunded to refundTo intents account | ORIGIN_CHAIN |
| slippageTolerance | No | (Optional, defaults to 100) Slippage tolerance for the swap. This value is in basis points (1/100th of a percent), e.g. 100 for 1% slippage. | |
| dry | No | (Optional, defaults to false) Flag indicating whether this is a dry run request. If true, the response will NOT contain the following fields: depositAddress, timeWhenInactive, deadline. | |
| depositType | No | (Optional, defaults to ORIGIN_CHAIN) Type of the deposit address: ORIGIN_CHAIN - deposit address on the origin chain, INTENTS - account ID inside near intents to which you should transfer assets inside intents | ORIGIN_CHAIN |
| deadline | No | (Optional, defaults to 1 hour from now) Timestamp in ISO format, that identifies when user refund will begin if the swap isn't completed by then. It needs to exceed the time required for the deposit tx to be minted, e.g. for Bitcoin it might require ~1h depending on the gas fees paid. | 2026-05-28T01:06:14.489Z |
| referral | No | (Optional) Referral identifier (lower case only). It will be reflected in the on-chain data and displayed on public analytics platforms. | |
| quoteWaitingTimeMs | No | (Optional, defaults to 3000) Time in milliseconds user is willing to wait for quote from relay |