Reports

Spending reports and portfolio snapshots. Aggregate raw ledger data into actionable summaries with operation breakdown, chain distribution, and error tracking.

Spending Reports

# today's activity
owl report daily

# last 7 days, filtered by wallet
owl report weekly -w main

# last 30 days
owl report monthly

Flag	Description
-w, --wallet	Filter by wallet name	optional

Reports include total operations, write vs read breakdown, error count, swap/transfer/bridge counts, chain distribution, and the 10 most recent write operations.

Portfolio View

owl report portfolio

Queries all wallets across all supported chains (Solana, Ethereum, Base, Polygon, Arbitrum, Optimism, BNB, Avalanche) and returns a unified view. One command to answer "what do I have?"

  main
    [solana]
      SOL: 12.4  USDC: 500.0
    [ethereum]
      ETH: 0.8  USDC: 200.0
    [base]
      ETH: 0.1

  trading
    [solana]
      SOL: 2.0  BONK: 10000000

Agent Usage

In the terminal agent, ask naturally:

Spending

"Show my weekly report" or "how many swaps did I do today?"

Portfolio

"What's my total across all wallets?" or "show all my balances"

MCP Tools

Tool	Description
owl_report_generate	Generate a spending report (daily, weekly, monthly)
owl_portfolio_all	Unified portfolio across all wallets and chains