Transfer Liquidity

Moves liquidity between markets, specifying source/destination addresses plus amounts of LP, principal, and yield tokens. Optional parameters (slippage, redeemRewards, zeroPriceImpact) fine-tune the transaction, with a reference ID for tracking.

💡

Compute Unit Value: 125 (Fixed)

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The request body for a /defi/v1/yieldaggregator/transferliquidity

The request body for a /defi/v1/yieldaggregator/transferliquidity

string
enum

A unique identifier to route the transaction to the correct yield aggregator instance. This parameter is optional if a default aggregator is used.

Allowed:
string
required

The blockchain address of the source market from which liquidity is being transferred.

string
required

Blockchain address of the sender. For EVM chains, use a checksummed hex address (e.g., 0xABCDEF...). This address must hold sufficient balance and will sign the transaction.

string
required

The blockchain address of the destination market where the liquidity will be deposited.

string
required

Amount of liquidity provider (LP) tokens to transfer, specified in the token's smallest denomination (base units). Example: 1 LP token (18 decimals) = "1000000000000000000".

string
required

Amount of principal tokens (PT) involved in the transfer, specified in the token's smallest denomination (base units). Principal tokens represent the original asset value deposited in the yield aggregator. Example: 1 PT token (18 decimals) = "1000000000000000000".

string
required

Amount of yield tokens (YT) to transfer, specified in the token's smallest denomination (base units). Yield tokens represent the accrued yield from the user's deposit. Example: 1 YT token (18 decimals) = "1000000000000000000".

string

Specifies the maximum acceptable percentage deviation between the expected and actual execution price during the liquidity removal. This helps protect against unfavorable price movements. The value is expressed as a percentage (e.g., 1 for 1%). Valid range: 0 to 100 (e.g., 1 = up to 1% slippage).

string

Maximum number of gas units to allocate for the transaction, as an integer string (e.g., '200000'). If omitted, gas is estimated automatically. Note: this is gas units, not wei or gwei.

boolean

An optional flag indicating whether accrued rewards should be redeemed as part of the liquidity transfer transaction.

boolean

When set to true, the transaction is executed to avoid any change in the asset’s price, resulting in the user receiving both LP and YT tokens, though the LP amount will be lower than in standard mode.

string

Specifies the desired gas fee priority (e.g., 'low', 'medium', or 'high'), which influences the transaction speed and cost.

boolean

Flag to include a basis points fee transaction alongside the main transaction when set to true.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json