SIM-4339: Add exclude_unpriced schema/docs to balances endpoints

[bh2smith]

Summary

• update previous docs/schema change to match latest echo rename and semantics
• rename include_unpriced -> exclude_unpriced
• keep default behavior backward-compatible: unpriced balances are included by default
• make filtering unpriced balances an explicit opt-in via exclude_unpriced=true

Changes

• openapi.json
  • GET /v1/evm/balances/{address}: query param renamed to exclude_unpriced (boolean, default false)
  • GET /v1/evm/balances/{address}/stablecoins: same rename and semantics
  • descriptions updated to reflect: when true, unpriced balances are excluded; by default they are included
• evm/balances.mdx
  • section updated to Exclude unpriced balances
  • docs now state that unpriced balances are included by default; use exclude_unpriced=true to filter them out
• token-filtering.mdx
  • narrative updated to included-by-default behavior
  • curl example updated to use exclude_unpriced=true
• .well-known/ai-tools.json
  • balances and stablecoin tool input schemas renamed to exclude_unpriced
  • descriptions updated to exclusion semantics

Validation

• no remaining include_unpriced references in repo
• openapi.json and .well-known/ai-tools.json parse successfully via python3 -m json.tool

Slack Thread

  

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
sim-dune	🟢 Ready	View Preview	Apr 10, 2026, 7:07 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[bh2smith]

Looks good.

[bh2smith]

Corresponding amp PR: https://github.com/duneanalytics/echo/pull/3068