simplify response descriptions

Author: ivpusic

cmd/sim/evm/activity.go

@@ -26,14 +26,9 @@ func NewActivityCmd() *cobra.Command {
 			"  - approve: ERC20/ERC721 spending approvals\n" +
 			"  - call: contract interactions with decoded function name and inputs\n\n" +
 			"Asset types: native, erc20, erc721, erc1155.\n\n" +
-			"Response fields per activity item:\n" +
-			"  - chain_id, block_number, block_time, tx_hash: transaction context\n" +
-			"  - type: activity classification (send, receive, swap, etc.)\n" +
-			"  - asset_type: token standard (native, erc20, erc721, erc1155)\n" +
-			"  - value, value_usd: transfer amount and USD value at time of transaction\n" +
-			"  - token_metadata: symbol, decimals, name, logo, price_usd\n" +
-			"  - For swaps: from_token_*, to_token_* fields with both sides of the trade\n" +
-			"  - For calls: function signature, name, and decoded inputs\n\n" +
+			"Each activity item includes the transaction context, transfer amounts with\n" +
+			"USD values, and token metadata. Swap entries include both sides of the trade.\n" +
+			"Call entries include the decoded function name and inputs.\n\n" +
 			"By default, returns all activity types across all default chains.\n" +
 			"Run 'dune sim evm supported-chains' to see which chains support activity.\n\n" +
 			"For raw transaction data (hashes, gas, calldata), use 'dune sim evm transactions'.\n\n" +

cmd/sim/evm/balance.go

@@ -21,11 +21,6 @@ func NewBalanceCmd() *cobra.Command {
 			"Both --token and --chain-ids are required. Use the literal string 'native'\n" +
 			"as the --token value to query the chain's native asset (e.g. ETH on Ethereum,\n" +
 			"MATIC on Polygon), or pass an ERC20 contract address.\n\n" +
-			"Response fields:\n" +
-			"  - chain, chain_id: network name and numeric ID\n" +
-			"  - address, symbol, name, decimals: token identity\n" +
-			"  - amount: raw balance (divide by 10^decimals for human-readable)\n" +
-			"  - price_usd, value_usd: current pricing and total value\n\n" +
 			"For multi-token or multi-chain lookups, use 'dune sim evm balances' instead.\n\n" +
 			"Examples:\n" +
 			"  dune sim evm balance 0xd8da... --token native --chain-ids 1\n" +

cmd/sim/evm/balances.go

@@ -17,16 +17,9 @@ func NewBalancesCmd() *cobra.Command {
 		Use:   "balances <address>",
 		Short: "Get EVM token balances for a wallet address across multiple chains",
 		Long: "Return native and ERC20 token balances for the given wallet address across\n" +
-			"supported EVM chains. Each balance entry includes the token amount, current\n" +
-			"USD price, and total USD value. Data comes from Dune's real-time index.\n\n" +
-			"Response fields per balance:\n" +
-			"  - chain, chain_id: network name and numeric ID\n" +
-			"  - address: token contract address (or native asset identifier)\n" +
-			"  - symbol, name, decimals: token identity and precision\n" +
-			"  - amount: raw token balance (divide by 10^decimals for human-readable)\n" +
-			"  - price_usd, value_usd: current token price and total holding value\n" +
-			"  - low_liquidity: true if on-chain liquidity is thin (price may be unreliable)\n" +
-			"  - pool_size: USD liquidity depth of the pricing pool\n\n" +
+			"supported EVM chains. Each balance entry includes the token identity, raw\n" +
+			"balance amount, current USD price, total USD value, and liquidity indicators.\n" +
+			"Data comes from Dune's real-time index.\n\n" +
 			"By default, queries all chains tagged 'default'. Use --chain-ids to restrict\n" +
 			"to specific networks. Run 'dune sim evm supported-chains' to see valid IDs.\n\n" +
 			"For a single-token balance lookup, use 'dune sim evm balance' instead.\n" +

cmd/sim/evm/collectibles.go

@@ -16,19 +16,10 @@ func NewCollectiblesCmd() *cobra.Command {
 		Use:   "collectibles <address>",
 		Short: "Get NFT collectibles (ERC721/ERC1155) held by a wallet address",
 		Long: "Return ERC721 and ERC1155 collectibles (NFTs) held by the given wallet\n" +
-			"address across supported EVM chains. Results include token metadata, images,\n" +
-			"and acquisition timestamps. Spam filtering is enabled by default to hide\n" +
+			"address across supported EVM chains. Each entry includes the collection and\n" +
+			"token identity, image URL, quantity held, acquisition timestamp, and spam\n" +
+			"classification when requested. Spam filtering is enabled by default to hide\n" +
 			"airdropped junk NFTs.\n\n" +
-			"Response fields per collectible:\n" +
-			"  - contract_address: NFT collection contract\n" +
-			"  - token_id: unique token identifier within the collection\n" +
-			"  - token_standard: 'erc721' or 'erc1155'\n" +
-			"  - chain, chain_id: network name and numeric ID\n" +
-			"  - name, symbol, description: collection metadata\n" +
-			"  - image_url: token image (may be IPFS, HTTP, or data URI)\n" +
-			"  - balance: quantity held (always '1' for ERC721, may be >1 for ERC1155)\n" +
-			"  - last_acquired: timestamp of most recent acquisition\n" +
-			"  - is_spam, spam_score: spam classification (visible with --show-spam-scores)\n\n" +
 			"Spam filtering uses a scoring model based on collection traits (holder count,\n" +
 			"transfer patterns, metadata quality). Disable with --filter-spam=false to see\n" +
 			"all NFTs including suspected spam.\n\n" +

cmd/sim/evm/defi_positions.go

@@ -31,16 +31,10 @@ func NewDefiPositionsCmd() *cobra.Command {
 			"  - UniswapV2: AMM liquidity provider positions (Uniswap V2 and forks)\n" +
 			"  - Nft: Uniswap V3 concentrated liquidity positions (NFT-based)\n" +
 			"  - NftV4: Uniswap V4 concentrated liquidity positions (NFT-based)\n\n" +
-			"Response fields per position:\n" +
-			"  - type: position type discriminator (see above)\n" +
-			"  - chain_id: numeric EVM chain ID\n" +
-			"  - usd_value: total USD value of the position\n" +
-			"  - protocol: protocol name (e.g. 'uniswap_v3', 'aave_v3')\n" +
-			"  - Type-specific fields: token symbols, underlying assets, pool info,\n" +
-			"    calculated balances, tick ranges (for concentrated liquidity)\n\n" +
-			"Aggregations (in JSON output):\n" +
-			"  - total_usd_value: sum of all position values\n" +
-			"  - total_by_chain: USD value grouped by chain ID\n\n" +
+			"Each position includes the chain, USD value, protocol name, and type-\n" +
+			"specific details (token identities, pool info, balances). The response\n" +
+			"also includes aggregation summaries with total value and per-chain\n" +
+			"breakdowns. Use -o json for the full structured response.\n\n" +
 			"Run 'dune sim evm supported-chains' to see which chains support defi-positions.\n\n" +
 			"Examples:\n" +
 			"  dune sim evm defi-positions 0xd8da6bf26964af9d7eed9e03e53415d37aa96045\n" +

cmd/sim/evm/supported_chains.go

@@ -16,15 +16,11 @@ func NewSupportedChainsCmd() *cobra.Command {
 		Use:   "supported-chains",
 		Short: "List supported EVM chains and their endpoint availability",
 		Long: "Display all EVM chains supported by the Sim API along with a capability\n" +
-			"matrix showing which endpoints are available for each chain.\n\n" +
+			"matrix showing which endpoints are available for each chain. Each chain\n" +
+			"entry includes the chain name, numeric ID, tags, and boolean flags\n" +
+			"indicating which Sim API endpoints are supported.\n\n" +
 			"This is a public endpoint and does not require a Sim API key.\n\n" +
-			"Response fields per chain:\n" +
-			"  - name: human-readable chain name (e.g. 'ethereum', 'base', 'arbitrum')\n" +
-			"  - chain_id: numeric EVM chain ID (e.g. 1, 8453, 42161)\n" +
-			"  - tags: grouping labels (e.g. 'default') usable in --chain-ids filters\n" +
-			"  - balances, activity, transactions, token_info, token_holders,\n" +
-			"    collectibles, defi_positions: boolean support flags per endpoint\n\n" +
-			"Use the chain_id values or tag names from this output as --chain-ids\n" +
+			"Use the chain IDs or tag names from this output as --chain-ids\n" +
 			"arguments in other 'dune sim evm' commands.\n\n" +
 			"Examples:\n" +
 			"  dune sim evm supported-chains\n" +

cmd/sim/evm/token_holders.go

@@ -22,12 +22,9 @@ func NewTokenHoldersCmd() *cobra.Command {
 			"Both --chain-id (single numeric chain ID) and the token address argument are\n" +
 			"required. Unlike other sim evm commands that accept --chain-ids (plural),\n" +
 			"this command uses --chain-id (singular) and queries exactly one chain.\n\n" +
-			"Response fields per holder:\n" +
-			"  - wallet_address: holder's Ethereum address\n" +
-			"  - balance: raw token balance (divide by 10^decimals for human-readable)\n" +
-			"  - first_acquired: timestamp of the holder's earliest token acquisition\n" +
-			"  - has_initiated_transfer: whether the holder has ever sent tokens (useful\n" +
-			"    for distinguishing active holders from passive recipients/airdrops)\n\n" +
+			"Each holder entry includes the wallet address, token balance, earliest\n" +
+			"acquisition timestamp, and whether they have ever initiated an outgoing\n" +
+			"transfer (useful for distinguishing active holders from airdrop recipients).\n\n" +
 			"Results are paginated; use --offset with the next_offset value from a\n" +
 			"previous response to retrieve additional pages.\n\n" +
 			"Run 'dune sim evm supported-chains' to see which chains support token-holders.\n\n" +

cmd/sim/evm/token_info.go

@@ -19,14 +19,9 @@ func NewTokenInfoCmd() *cobra.Command {
 			"specified EVM chain. Use the literal string 'native' as the address to query\n" +
 			"the chain's native asset (e.g. ETH on chain 1, MATIC on chain 137).\n\n" +
 			"The --chain-ids flag is required and should specify a single chain ID.\n\n" +
-			"Response fields per token:\n" +
-			"  - chain, chain_id: network name and numeric ID\n" +
-			"  - symbol, name, decimals: token identity and precision\n" +
-			"  - price_usd: current USD price from on-chain DEX liquidity pools\n" +
-			"  - total_supply: total token supply (raw, divide by 10^decimals)\n" +
-			"  - market_cap: estimated market capitalization in USD\n" +
-			"  - logo: URL to the token's icon image\n" +
-			"  - historical_prices: past USD prices at requested hour offsets\n\n" +
+			"Returns the token identity, current USD price (from on-chain DEX pools),\n" +
+			"total supply, estimated market cap, and logo. Use --historical-prices to\n" +
+			"include past USD prices at specified hour offsets.\n\n" +
 			"This command is useful for looking up token details before querying\n" +
 			"balances or activity. For wallet-scoped token data, use\n" +
 			"'dune sim evm balances' or 'dune sim evm balance'.\n\n" +

cmd/sim/evm/transactions.go

@@ -16,16 +16,9 @@ func NewTransactionsCmd() *cobra.Command {
 		Use:   "transactions <address>",
 		Short: "Get raw EVM transaction history for a wallet address across chains",
 		Long: "Return raw transaction history for the given wallet address across supported\n" +
-			"EVM chains. Transactions are returned in reverse-chronological order.\n\n" +
-			"Response fields per transaction:\n" +
-			"  - chain: network name (e.g. 'ethereum', 'base')\n" +
-			"  - hash: transaction hash\n" +
-			"  - from, to: sender and recipient addresses\n" +
-			"  - value: native currency amount transferred (in wei)\n" +
-			"  - block_number, block_time: block context\n" +
-			"  - gas_price, max_fee_per_gas, max_priority_fee_per_gas: gas parameters\n" +
-			"  - transaction_type: EIP-2718 type (e.g. legacy, EIP-1559)\n" +
-			"  - data: raw calldata hex (available in JSON output)\n\n" +
+			"EVM chains. Transactions are returned in reverse-chronological order. Each\n" +
+			"transaction includes the hash, sender/recipient, value, block context, gas\n" +
+			"parameters, and raw calldata.\n\n" +
 			"Use --decode with -o json to include ABI-decoded function calls and event\n" +
 			"logs. Decoded data adds 'decoded' fields with function name and typed inputs,\n" +
 			"plus 'logs' with decoded event emissions. Note: --decode data is only visible\n" +

cmd/sim/svm/balances.go

@@ -16,21 +16,11 @@ func NewBalancesCmd() *cobra.Command {
 		Use:   "balances <address>",
 		Short: "Get SPL token balances for an SVM wallet address with USD valuations",
 		Long: "Return SPL token balances for the given SVM (Solana Virtual Machine) wallet\n" +
-			"address. Each balance entry includes the token amount, current USD price,\n" +
-			"and total USD value. Data comes from Dune's real-time index.\n\n" +
+			"address. Each balance entry includes the token identity, balance (both raw\n" +
+			"and human-readable), current USD price, total USD value, and liquidity data.\n" +
+			"Data comes from Dune's real-time index.\n\n" +
 			"Supported chains: Solana, Eclipse (default: Solana only).\n\n" +
 			"Note: This endpoint is in beta (served under /beta/svm/balances/*).\n\n" +
-			"Response fields per balance:\n" +
-			"  - chain: network name ('solana' or 'eclipse')\n" +
-			"  - address: SPL token mint address\n" +
-			"  - amount: raw token balance; balance: human-readable balance\n" +
-			"  - symbol, name: token identity\n" +
-			"  - decimals: token precision\n" +
-			"  - price_usd, value_usd: current pricing and total holding value\n" +
-			"  - liquidity_usd: USD liquidity depth of the pricing pool\n" +
-			"  - program_id: owning program (e.g. SPL Token program)\n" +
-			"  - total_supply: total token supply\n" +
-			"  - mint_authority: address authorized to mint new tokens\n\n" +
 			"Results are paginated; use --offset with the next_offset value from a\n" +
 			"previous response to retrieve additional pages.\n\n" +
 			"Examples:\n" +