> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polygon.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfers

> Send native tokens or ERC-20s from the smart wallet. Dry-run by default; broadcast with --broadcast.

Three commands cover transfers: `send` auto-detects between native and ERC-20 based on `--symbol`, `send-native` is the explicit native path, and `send-token` is for ERC-20s by symbol or contract address. Every transfer is dry-run by default, the CLI prints the planned transaction and exits without broadcasting. Add `--broadcast` only when the plan is correct.

Use dry-run to review the recipient, amount, fee, and chain before any funds move. For batch payouts, run dry-runs across the entire batch first; broadcast the batch only after every dry-run passes.

***

## How it works

Transfer flow

1
Operator
→
CLI
polygon-agent send-token ... (no --broadcast)

2
CLI
Prints dry-run summary: amount, symbol, recipient, fee

3
Operator
→
CLI
Re-runs with --broadcast

4
Smart wallet
→
Polygon
Submits transaction

5
CLI
→
Operator
Prints tx hash + explorer link

The spending-limit caps set at `wallet create` time bound every transfer. A transfer that exceeds its cap fails at dry-run; no funds move and the wallet does not need to re-approve.

***

## Commands

### send

```bash theme={null}
polygon-agent send --to 0xRecipient --amount 10 --symbol USDC
```

`send` is the convenience command: pass `--symbol` to send ERC-20s, omit it to send the native token.

| Flag | Default | Purpose |
| - | - | - |
| `--wallet` | `main` | Wallet name |
| `--chain` | none | Chain (defaults to wallet's chain) |
| `--to` | required | Recipient address |
| `--amount` | required | Amount to send |
| `--symbol` | none | Token symbol for ERC-20 (omit for native) |
| `--token` | none | Token contract address (overrides `--symbol`) |
| `--decimals` | none | Token decimals (use with `--token`) |
| `--broadcast` | `false` | Execute the transaction |

### send-native

```bash theme={null}
polygon-agent send-native --to 0xRecipient --amount 0.5
```

Explicit native-token transfer. The `--direct` flag bypasses the Sequence ValueForwarder for cases where the smart wallet needs to send native directly.

| Flag | Default | Purpose |
| - | - | - |
| `--wallet` | `main` | Wallet name |
| `--chain` | none | Chain |
| `--to` | required | Recipient address |
| `--amount` | required | Amount to send |
| `--direct` | `false` | Bypass ValueForwarder |
| `--broadcast` | `false` | Execute the transaction |

### send-token

```bash theme={null}
polygon-agent send-token --symbol USDC --to 0xRecipient --amount 100
```

Explicit ERC-20 transfer. Use `--symbol` for known tokens or `--token --decimals` for arbitrary contracts.

| Flag | Default | Purpose |
| - | - | - |
| `--wallet` | `main` | Wallet name |
| `--chain` | none | Chain |
| `--symbol` | none | Token symbol (e.g. `USDC`, `WETH`) |
| `--token` | none | Token contract address |
| `--decimals` | none | Token decimals (with `--token`) |
| `--to` | required | Recipient address |
| `--amount` | required | Amount to send |
| `--broadcast` | `false` | Execute the transaction |

***

## Worked example

```bash theme={null}
# Step 1: Dry-run to confirm the plan
polygon-agent send-token --symbol USDC --to 0xVendor --amount 25

# ⚡ Dry run
# Send 25.00 USDC to 0xVendor on polygon
# Fee: 0.0001 USDC
# Wallet balance after: 75.00 USDC

# Step 2: Broadcast once verified
polygon-agent send-token --symbol USDC --to 0xVendor --amount 25 --broadcast

# Sent 25.00 USDC to 0xVendor on polygon
# Tx: 0xabc... → https://polygonscan.com/tx/0xabc...
```

***

## Implementation

> [card] [CLI overview](https://docs.polygon.technology/payment-services/agentic-payments/cli/index.md)
>
> Topology and safety model.

> [card] [Balances and funding](https://docs.polygon.technology/payment-services/agentic-payments/cli/balances-and-funding.md)
>
> Confirm balance before and after.

> [card] [Swaps and yield](https://docs.polygon.technology/payment-services/agentic-payments/cli/swaps-and-yield.md)
>
> Cross-chain transfers, swaps, and yield positions.

> [card] [Setup and wallets](https://docs.polygon.technology/payment-services/agentic-payments/cli/setup-and-wallets.md)
>
> Spending limits set the bounds on transfers.
