Swap plan with every fee (no trade is made)
plan_swapRead-onlyIdempotent
Plan a swap the way Realtap's own router places it: one order, or the amount split over several pools of Minswap V2, SundaeSwap V3 and WingRiders V2, with the expected and the minimum amount received at the given slippage, every fee in ADA (DEX batcher fees, interface fee, network fee), the refundable deposit, the price impact (percent) and the result net of fees. More exact than get_swap_quote (integer pool maths, fees included) but limited to those three DEXes. Nothing is built or signed: a person executes the plan at swapUrl; an agent that signs with its own key calls build_swap_transaction.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"tokenIn": "<tokenIn>",
"tokenOut": "<tokenOut>",
"amount": "<amount>"
},
"name": "plan_swap"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Amount of tokenIn to sell, decimal-adjusted (100 = 100 ADA when tokenIn is ADA). | |
| tokenIn | Yes | What is sold: a token unit, or "lovelace" / "ADA" for ADA. | |
| tokenOut | Yes | What is bought: a token unit, or "lovelace" / "ADA" for ADA. | |
| maxOrders | No | Most orders the amount may be split over (1 = a single order). | |
| slippagePct | No | How far the price may move against the trade before an order must not execute, in percent (1 = 1 %). |