Execute token swaps on Sui using the 7K Protocol for aggregation, ensuring slippage protection.
Usage
// Swap token use symbol
const result = await agent.swap({
fromToken: "SUI";
toToken: "USDC";
inputAmount: 1;
slippage: 0.01; // 1%
})
// Swap token use address
const result = await agent.swap({
fromToken: "SUI";
toToken: "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
inputAmount: 1;
slippage: 0.01; // 1%
})
Parameters
| Parameter | Type | Required | Description |
|---|
| fromToken | string | Yes | Address or symbol of the input token |
| toToken | string | Yes | Address or symbol of the output token |
| inputAmount | number | Yes | Amount of the input token to swap |
| slippage | number | No | Maximum allowable slippage (e.g., 0.01 for 1%) |
Example Prompts
Natural Language Prompts
"Swap 1 SUI for USDC"
"Exchange 100 USDC for SUI with 1% slippage"
"Convert 50 USDT to SUI"
// Swap Sui for USDC
{
"fromToken": "SUI";
"toToken": "USDC";
"inputAmount": 1;
"slippage": 0.01; // 1%
}
// Swap Sui for USDC
{
"fromToken": "SUI";
"toToken": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC";
"inputAmount": 1;
"slippage": 0.01; // 1%
}
Example Implementation
import { SuiAgentKit } from "sui-agent-kit";
async function executeSwaps(agent: SuiAgentKit) {
try {
const res = await agent.swap({
fromToken: "SUI",
toToken: "USDC",
inputAmount: 100,
slippage: 0.01, // 1%
});
console.log("Swap result:", res);
} catch (error) {
console.error("Swap failed:", error);
}
}
Implementation Details
- Uses 7k Protocol for best prices
- Dynamic compute unit limits
- Auto-calculated priority fees
- Direct route optimization
Error Handling
try {
const res = await agent.swap({
fromToken: "SUI",
toToken: "USDC",
inputAmount: 100,
slippage: 0.01, // 1%
});
} catch (error) {
if (error.message.includes("Insufficient balance")) {
// Handle insufficient balance
} else {
// Handle other transaction failures
}
}
Best Practices
- Slippage Management
- Use appropriate slippage for token
- Consider market volatility
- Monitor price impact
- Handle failed transactions
- Amount Calculation
- Account for token decimals
- Check minimum amounts
- Consider fees
- Verify available balance
- Error Handling
- Implement retries
- Monitor transaction status
- Handle timeouts
- Verify swap results
- Performance
- Use direct routes when possible
- Set appropriate compute limits
- Monitor network conditions
- Consider priority fees
// Successful response
{
status: "success",
result: {
tx_hash: "5JvBtQveYFsZFYxXMfSxYzUJgzGfyRgkH9YuZxpvuR9Y",
tx_status: "success",
},
}
// Error response
{
status: "error",
message: "Error message here",
code: "ERROR_CODE"
}
- get_holding: Check token balances
- transfer: Transfer token.
