Swaps and yield

Three commands cover treasury movement beyond simple transfers. swap routes through the Trails DEX API, including cross-chain swaps via --to-chain. deposit parks idle balances in Trails earn pools (Aave v3, Morpho, ERC-4626 vaults). withdraw exits those positions, with auto-discovery if you know only the asset and protocol. The CLI picks the highest-TVL pool by default; pass --protocol to constrain. All three are dry-run by default. Pass --broadcast to execute.

How it works

Treasury sweep flow

1Operator→CLIpolygon-agent swap —from USDT —to USDC …

2CLI→TrailsRoutes swap quote and gas across DEX aggregators

3Smart wallet→PolygonSwap executes; output token received

4Operator→CLIpolygon-agent deposit —asset USDC —amount 1000

5Trails→Aave / MorphoDeposits into highest-TVL pool by default

--defi at wallet create time gives the smart wallet permission to interact with Aave v3, Morpho, and ERC-4626 vaults. Without --defi, deposit and withdraw fail with a session-rejection error before any funds move.

Commands

swap

polygon-agent swap --from USDC --to WETH --amount 100
polygon-agent swap --from USDC --to USDC --amount 100 --to-chain base --broadcast

DEX swap routed through Trails. Pass --to-chain to bridge during the swap.

Flag	Default	Purpose
`--wallet`	`main`	Wallet name
`--chain`	none	Source chain
`--from`	required	Source token symbol
`--to`	required	Destination token symbol
`--amount`	required	Amount to swap
`--slippage`	none	Tolerance 0–0.5 (e.g. `0.005` for 0.5%)
`--to-chain`	none	Destination chain for cross-chain swap
`--broadcast`	`false`	Execute the transaction

deposit

polygon-agent deposit --asset USDC --amount 1000
polygon-agent deposit --asset USDC --amount 1000 --protocol aave --broadcast

Deposit into a Trails earn pool. With no --protocol, the CLI auto-selects the highest-TVL pool for the asset. --protocol aave or --protocol morpho constrains the choice.

Flag	Default	Purpose
`--wallet`	`main`	Wallet name
`--chain`	none	Chain
`--asset`	`USDC`	Asset symbol
`--amount`	required	Amount to deposit
`--protocol`	none	Filter: `aave` or `morpho`
`--broadcast`	`false`	Execute the transaction

withdraw

# By auto-discovery
polygon-agent withdraw --asset USDC --protocol aave --amount max
# By explicit position address
polygon-agent withdraw --position 0xPool... --amount 500

Withdraw from an Aave v3 aToken position or an ERC-4626 vault. Use --amount max for a full exit.

Flag	Default	Purpose
`--wallet`	`main`	Wallet name
`--chain`	none	Chain
`--position`	none	aToken or vault share address
`--asset`	none	Asset symbol (use with `--protocol` to auto-discover)
`--protocol`	none	`aave` or `morpho`
`--amount`	required	Underlying amount (Aave) or `max` / partial (ERC-4626)
`--broadcast`	`false`	Execute the transaction

Worked example

# Sweep idle USDC into Aave v3
polygon-agent deposit --asset USDC --amount 5000 --protocol aave
# ⚡ Dry run, pool: 0x794a..., projected APY 4.8%

polygon-agent deposit --asset USDC --amount 5000 --protocol aave --broadcast
# Deposited 5000.00 USDC to Aave v3
# Tx: 0xabc... → https://polygonscan.com/tx/0xabc...

# Pull funds back when an initiative kicks off
polygon-agent withdraw --asset USDC --protocol aave --amount max --broadcast
# Withdrew 5,012.34 USDC from Aave v3 (principal + yield)
# Tx: 0xdef...

Implementation

Setup and wallets

Pass --defi at wallet creation to enable swaps and yield.

Transfers

Plain token transfers; no DEX routing.

Trails

The underlying DEX and earn-pool router.

Agentic Payments

Agentic Services

Use Cases

Polygon Agent CLI

x402 Protocol

How it works

Commands

swap

deposit

withdraw

Worked example

Implementation

Setup and wallets

Transfers

Trails

​How it works

​Commands

​swap

​deposit

​withdraw

​Worked example

​Implementation

Setup and wallets

Transfers

Trails

How it works

Commands

swap

deposit

withdraw

Worked example

Implementation