Trade Tools

Prerequisite: All trade tools require an active authenticated session. Call get_auth_status first to verify.

Recommended Flow

Always follow the quote → confirm → execute pattern:

1. get_swap_quote       →  Show quote to user
2. User confirms        →  Proceed to execute
3. swap_tokens          →  Execute the swap
4. get_tx_status        →  Verify confirmation

get_swap_quote

Get a price quote for a swap without executing. Always call this before swap_tokens so the user can review the expected output.

This is a read-only tool — safe to call without user confirmation. Returns expected output amount, estimated gas cost, and route details.

swap_tokens

Execute a token swap on Starknet using Fibrous DEX aggregation.

Important: Always call get_swap_quote first and confirm with the user before executing.

get_multi_swap_quote

Get quotes for 2–3 swap pairs at once using Fibrous batch routing.

Each swap object: { amount, from_token, to_token }

This is a read-only tool — safe to call without user confirmation.

multi_swap

Execute 2–3 swaps in a single multicall transaction. Call get_multi_swap_quote first to preview.

Each swap object: { amount, from_token, to_token }

Note: Minimum 2, maximum 3 swap pairs per transaction.

batch_execute

Execute a batch of mixed operations (swap + stake + supply + send) atomically in a single Starknet multicall.

Each operation has a type and params:

Note: Minimum 2 operations required per batch. Each operation is executed atomically — if any fails, the entire batch reverts.