Skip to main content
The Snack Money CLI is a command-line tool for sending USDC payments to users on X (Twitter), Farcaster, GitHub, Email, and Web using the x402 protocol.

​
Key Features

  • No wallet addresses needed - Send to social usernames directly
  • Multi-chain support - Works on Base and Solana networks
  • Batch payments - Send to multiple users at once
  • AI agent mode - Use natural language for payments
  • Simple installation - No setup required with npx

​
Supported Platforms

Send USDC payments to users on these platforms:
PlatformFormatsExample
X (Twitter)x/username
x.com/username
twitter.com/username		x/aeyakovenko
Farcasterfarcaster/username
farcaster.xyz/username		farcaster/toly
GitHubgithub/username
github.com/username		github/octocat
Emailemail/addressemail/[email protected]
Webweb/domainweb/snack.money

​
Supported Networks

  • Base - EVM-compatible chain (requires EVM_PRIVATE_KEY)
  • Solana - SVM chain (requires SVM_PRIVATE_KEY)
The CLI automatically detects which network to use based on your configured private key.

​
Available Commands

​
send - Single Payment

Send USDC to a single user: 
npx snackmoney send x/aeyakovenko 1¢
npx snackmoney send farcaster/toly $0.5
npx snackmoney send github/octocat 0.01
npx snackmoney send email/[email protected] $0.25
npx snackmoney send web/snack.money 0.5
Learn more →

​
batch-send - Batch Payments

Send to multiple users at once: 
npx snackmoney batch-send x/user1:1¢,user2:2¢,user3:3¢
npx snackmoney batch-send ./payments.json
Learn more →

​
ai-agent - AI-Powered Payments

Use natural language to describe payments: 
npx snackmoney ai-agent --prompt "Send 1 USDC to @toly on Farcaster"
Learn more →

​
Amount Formats

The CLI supports flexible amount formats:
  • Cents: 1¢, 50¢, 99¢
  • Dollars: $0.01, $0.5, $1
  • Decimal: 0.01, 0.5, 1
All amounts are processed as USDC.

​
Quick Start

Get started in 3 steps:
  1. Set your private key: 
    export EVM_PRIVATE_KEY="your_private_key"  # For Base
# OR
export SVM_PRIVATE_KEY="your_private_key"  # For Solana
  2. Run a payment: 
    npx snackmoney send x/username 0.01
  3. Check the receipt: The CLI returns a receipt URL to view your payment.
See detailed quick start guide →

​
Installation Options

Choose your preferred installation method: No installation required: 
npx snackmoney --help

​
npm Global

Install globally: 
npm install -g snackmoney
snackmoney --help

​
Homebrew

For macOS/Linux: 
brew tap snack-money/tap
brew install snackmoney
See all installation options →

​
Why Use the CLI?

  • Quick testing - Test the API without writing code
  • Scripting - Automate payments in shell scripts
  • Batch operations - Process multiple payments efficiently
  • No dependencies - Works standalone with npx
  • Developer-friendly - Simple, intuitive commands

​
Next Steps