---
name: suibrokers-swap
description: Use for public SUI BROKERS swap history and review-only swap preparation; never for signing, sending, quoting, or building a transaction.
---

# SUI BROKERS Swap

Use this skill when a participant asks about verified wallet swap history, the Points rule, or how to prepare a swap review. Read [references/api.md](references/api.md) when endpoint fields or state handling matters.

1. Ask for the intended canonical Sui wallet before a wallet-scoped read. A read may use `suibrokers_get_swap_history` with a bounded limit and optional cursor or digest.
2. Report the tool's raw data and `source.origin`, `source.endpoint`, and `source.asOf`. Keep an empty verified history (`zero`) separate from an unavailable service and from an explicit pending or confirmed API state.
3. For a possible swap, call `suibrokers_prepare_action` only after the user supplies the wallet, decimal amount, and two validated coin types. Explain that the returned plan is not a quote or transaction.
4. Direct the user to the in-app route to review assets, recipient, network, fees, and final transaction. The user signs explicitly in their wallet and waits for confirmed ledger readback.

Verified activity can earn Points only after the service confirms and verifies it. Prompts, installation, simulations, plans, and unconfirmed transactions earn no Points. Never invent a Points total, price, route, allocation, or fee.