solana-payments-wallets-trading

Original：🇺🇸 English
Translated

Pay people in SOL or USDC, buy and sell tokens, check prices, manage Solana wallets, stake SOL, earn yield through lending, and track portfolio performance — all from the command line. No API keys, no private key env vars. Use when the user wants to send crypto, trade, check balances, earn yield, or see how their holdings are doing.

9installs
Sourcesolanaguide/solana-cli
Added on

NPX Install

npx skill4agent add solanaguide/solana-cli solana-payments-wallets-trading

Tags

Translated version includes tags in frontmatter
solana-clicrypto-wallet-managementtoken-tradingsol-stakingportfolio-tracking

SKILL.md Content

View Translation Comparison →

Payments, Wallets and Trading on Solana

Sol is a command-line tool that lets you work with Solana the way you'd describe it out loud. Instead of constructing transactions and managing program instructions, you say what you want: pay someone, buy a token, stake your SOL.
Keys live locally on disk — no private keys in environment variables, no API keys to configure.

Get Set Up

Prefer 
npx
— it always runs the latest version with no global install to manage:
bash
npx @solana-compass/cli config set rpc.url https://your-rpc-endpoint.com
npx @solana-compass/cli wallet create --name my-wallet
If the user has installed globally (
npm install -g @solana-compass/cli
), you can use the shorter 
sol
command instead:
bash
sol config set rpc.url https://your-rpc-endpoint.com
sol wallet create --name my-wallet
The public RPC endpoint rate-limits aggressively. Use a dedicated RPC for anything beyond testing — Helius, Triton, and QuickNode all offer free tiers.
Requires Node.js >= 20.

Pay Someone

Send SOL, USDC, or any Solana token to a wallet address.
bash
sol token send 50 usdc GkX...abc
sol token send 2 sol 7nY...xyz
sol token send 1000 bonk AgE...def --yes
Use 
--yes
to skip the confirmation prompt — useful for automated payments between agents or apps. Confirmations are also skipped automatically in 
--json
mode.
See references/trading-commands.md for the full send reference.

Discover Tokens

Browse the Solana token ecosystem — trending, most traded, recently launched, and more.
bash
sol token browse trending                    # what's hot right now
sol token browse top-traded --interval 24h   # highest volume over 24h
sol token browse recent --limit 10           # just launched
sol token browse lst                         # liquid staking tokens
Results populate the local token cache, so subsequent 
token info
and 
token price
calls resolve instantly.
See references/trading-commands.md for all categories and flags.

Buy and Sell Tokens

Swap any token for any other token. Prices come from Jupiter — best rate across every Solana DEX, no API key needed.
bash
sol token swap 50 usdc bonk             # buy BONK with USDC
sol token swap 1.5 sol usdc             # sell SOL for USDC
sol token swap 50 usdc bonk --quote-only  # preview without executing
Every swap records the price at execution time, so you can track cost basis and P&L later.
See references/trading-commands.md for slippage, wallet selection, etc.

Check Prices

bash
sol token price sol
sol token price sol usdc bonk eth       # multiple at once

See What You Have

bash
sol wallet balance                      # all tokens with USD values
sol wallet balance trading              # specific wallet by name
sol token list                          # just token balances
sol wallet list                         # all your wallets

Create and Manage Wallets

Wallets are local key files in 
~/.sol/wallets/
— no seed phrases in environment variables.
bash
sol wallet create                       # new wallet, auto-named
sol wallet create --name trading        # pick a name
sol wallet import --solana-cli          # import from Solana CLI
sol wallet set-default trading          # switch active wallet
Any command can target a specific wallet with 
--wallet <name>
.
See references/wallet-commands.md for import, export, labels, history.

Stake SOL

Delegate SOL to a validator and earn staking rewards. One command handles the entire process — creating the stake account, funding it, and delegating.
bash
sol stake new 10                        # stake 10 SOL
sol stake list                          # your stake accounts + claimable tips
sol stake claim-mev                     # compound MEV rewards
sol stake withdraw 7gK...abc            # unstake
See references/staking-commands.md for validator selection, partial withdrawals, and force unstake.

Earn Yield by Lending

Deposit tokens into Kamino Finance to earn interest, or borrow against your deposits.
bash
sol lend rates usdc                     # current APY
sol lend deposit 100 usdc               # start earning
sol lend borrow 500 usdc --collateral sol
sol lend positions                      # everything you've got open
See references/lending-commands.md for full details.

Track How Your Portfolio Is Doing

See everything in one place — tokens, staked SOL, lending positions.
bash
sol portfolio                           # the full picture
sol portfolio snapshot --label "monday"
sol portfolio compare                   # what changed since last snapshot
sol portfolio pnl                       # profit and loss over time
See references/portfolio-commands.md for snapshot management.

Structured Output

Every command supports 
--json
for structured output. In JSON mode, confirmations are skipped automatically.
json
{ "ok": true, "data": { ... }, "meta": { "elapsed_ms": 450 } }
Error codes are 
UPPER_SNAKE_CASE
(e.g. 
SWAP_FAILED
). Check the 
ok
field before reading 
data
.
See references/json-output-format.md for the full schema.

Other Useful Commands

bash
sol network                             # epoch, TPS, staking APY
sol tx 4xK9...abc                       # look up any transaction
sol config set rpc.url <url>            # change RPC endpoint

Tips

  • Keep SOL for gas. Every Solana transaction costs ~0.000005 SOL, but token account creation costs ~0.002 SOL. Unless the user specifically asks to drain or close a wallet, keep at least 0.05 SOL as a reserve so future transactions don't fail.
  • Use full numbers, not shorthand. The CLI expects literal amounts: 
    1000000
    not 
    1m
    , 
    50000
    not 
    50k
    . Always expand shorthand before passing to a command.
  • Addresses are raw public keys only. The CLI does not resolve .sol domains, SNS names, or contact labels — pass the full base58 public key for recipients.
  • Ambiguous symbols pick the highest-liquidity match. If a symbol maps to multiple tokens, the CLI picks the one with the most trading volume on Jupiter. It does not prompt. Use 
    sol token info <symbol>
    to verify what it resolves to, or pass a mint address to be explicit.
  • Use 
    --quote-only
    on swaps to preview before committing
  • Use 
    --wallet <name>
    to target a specific wallet
  • The transaction log tracks all operations with USD prices at execution time — useful for cost basis and P&L

Permissions

The CLI supports fine-grained permissions via 
~/.sol/config.toml
. When a permission is set to 
false
, the gated commands are not registered — they won't appear in 
--help
or 
sol <group> --help
, and invoking them returns "unknown command".
All permissions default to 
true
(omitted = permitted). Example read-only config:
toml
[permissions]
canTransfer = false
canSwap = false
canStake = false
canWithdrawStake = false
canLend = false
canWithdrawLend = false
canBurn = false
canCreateWallet = false
canRemoveWallet = false
canExportWallet = false
PermissionGated subcommands
canTransfer
token send
canSwap
token swap
, 
token close --all
canStake
stake new
canWithdrawStake
stake withdraw
, 
stake claim-mev
canLend
lend deposit
, 
lend borrow
canWithdrawLend
lend withdraw
, 
lend repay
canBurn
token burn
, 
token close --burn
canCreateWallet
wallet create
, 
wallet import
canRemoveWallet
wallet remove
canExportWallet
wallet export
Read-only commands (
token browse/price/info/list
, 
wallet list/balance
, 
stake list
, 
lend rates/positions
, 
portfolio
, 
network
, 
tx
) are always available regardless of permissions.
Permissions cannot be changed via 
sol config set
— they must be edited in 
config.toml
directly.

Troubleshooting

See references/troubleshooting.md for common issues (RPC rate limits, token resolution, transaction timeouts).