{"name":"onyx_agent_budget_tracker","tier":"free","price_usdc":"0","endpoint":"https://onyx-actions.onrender.com/v1/onyx_agent_budget_tracker","method":"POST","input_schema":{"type":"object","properties":{"wallet_address":{"type":"string","description":"0x-prefixed EVM wallet to inspect."},"direction":{"type":"string","enum":["outflows","inflows","both"],"default":"outflows","description":"outflows = wallet as sender, inflows = wallet as recipient, both = aggregated."},"include_sepolia":{"type":"boolean","default":true,"description":"Include Base Sepolia testnet activity."}},"required":["wallet_address"]},"description":"Per-wallet USDC spend tracker. Given a wallet address and direction (outflows / inflows / both), scans USDC Transfer events on Base + Sepolia and returns: total volume, settlement count, top recipients with cumulative spend, hourly histogram of recent activity, average ticket size. Free tier — extension of onyx_agent_id.","when_to_use":"An agent needs to track its own USDC spend over the last ~24h (for budget alerts, cost reports). Or a service operator wants a list of who paid them. Direction=outflows for spend, inflows for revenue, both for net.","vs_alternatives":"Etherscan API requires keys + manual aggregation. Block explorers don't filter by wallet+side. This tool returns the breakdown in one call.","example_request":{"wallet_address":"0xA60939FFf9c04a61c0c0649943675e16A12D7074","direction":"inflows","include_sepolia":false},"example_response":{"ok":true,"summary":{"inflow_count":3,"inflow_total_usdc":1.5,"inflow_avg_ticket":0.5,"top_payers":[{"address":"0x...","tx_count":2,"total_usdc":1.0}]}},"settle_to":"0x3fD9ee1373562f894D322B37DFFAd7a5D2b2d78f","network":"base","facilitator":"https://facilitator.xpay.sh","payment_required":false,"free_introspection":true,"note":"GET this URL = free introspection card. POST with x402 payment header to call."}