Sim evm balances

[ivpusic]

Add dune sim evm balances <address> for querying multi-chain EVM token balances with --chain-ids, --filters, --exclude-spam, --historical-prices flags. Includes warning handling, amount formatting, text table and JSON output.

[ivpusic]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Add svm transactions command with signature extraction and block time formatting #39
• Add svm balances command with SimClient wiring #38
• Add evm defi-positions command for DeFi portfolio positions #37
• Add evm token-holders command with token address as positional arg #36
• Add evm token-info command for token metadata and pricing #35
• Add evm collectibles command for NFT listings with spam filtering #34
• Add evm transactions command and fix OpenAPI spec gaps across all EVM commands #33
• EVM activity #31
• Sim evm stablecoins #30
• Get balance #29
• Sim evm balances #28 👈 (View in Graphite)
• Supported chains #27
• Sim auth #26
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[cursor]

PR Summary

Low Risk
Low risk additive CLI change that introduces a new sim evm balances subcommand and associated formatting/parsing logic; main risk is incorrect query parameter mapping or output formatting when the Sim API response shape changes.

Overview
Adds a new authenticated CLI subcommand, dune sim evm balances <address>, to query the Sim API for native/ERC20 token balances across EVM chains with optional filtering, spam exclusion, historical pricing, and pagination (limit/offset).

Supports text table output (including amount/price/value formatting and next_offset hint) and passthrough json output, and prints any API warnings to stderr.

Introduces E2E tests for the new command (text/JSON, filters, exclude-spam, pagination) and refactors the existing supported-chains tests to reuse shared test helpers.

^{Written by Cursor Bugbot for commit 7a9a11d. Configure here.}