chore: improvements

Author: AyushBherwani1998

skills/metamask-agent-wallet/references/market-data.md

@@ -42,12 +42,13 @@ mm-dev price history --chain-id <caip2-chain-id> --asset-type <asset-type> [--ti
 
 | Name | Required | Description |
 | --- | --- | --- |
-| `--chain-id` | Yes | CAIP-2 chain ID |
-| `--asset-type` | Yes | Asset type, such as `slip44:60` |
-| `--time-period` | No | Period such as `1d`, `7d`, `2M`, or `3y` |
-| `--interval` | No | `5m`, `hourly`, or `daily` |
-| `--from` | No | Start unix timestamp |
-| `--to` | No | End unix timestamp |
+| `--chain-id` | Yes | CAIP-2 chain ID (e.g. `eip155:1`). Run `mm-dev price networks` to see supported chains |
+| `--asset-type` | Yes | CAIP-19 asset type (e.g. `slip44:60` for ETH, `erc20:0x...` for ERC-20 tokens) |
+| `--time-period` | No | Time period (e.g. `1d`, `7d`, `30d`, `2M`, `1y`, `3y`) |
+| `--interval` | No | Sampling interval: `5m`, `hourly`, or `daily` |
+| `--from` | No | Start time as a Unix timestamp in seconds. Use with `--to` instead of `--time-period` for custom ranges |
+| `--to` | No | End time as a Unix timestamp in seconds. Use with `--from` instead of `--time-period` for custom ranges |
+| `--vs` | No | Quote currency code (defaults to `usd`). Run `mm-dev price currencies` to see options |
 
 ### Example
 
@@ -162,21 +163,26 @@ Fetch asset metadata for one or more CAIP-19 assets.
 ### Syntax
 
 ```bash
-mm-dev token assets --asset-ids <asset-ids> [--include-market-data] [--include-token-security-data] [--include-labels]
+mm-dev token assets --asset-ids <asset-ids> [--include-market-data] [--include-token-security-data] [--include-labels] [--include-aggregators] [--include-coingecko-id] [--include-occurrences] [--include-rwa-data]
 ```
 
 ### Supported Flags
 
 | Name | Required | Description |
 | --- | --- | --- |
-| `--asset-ids` | Yes | Comma-separated CAIP-19 asset IDs |
-| `--include-market-data` | No | Include market data |
-| `--include-token-security-data` | No | Include token security signals |
-| `--include-labels` | No | Include token labels |
+| `--asset-ids` | Yes | Comma-separated CAIP-19 asset IDs (e.g. `eip155:1/erc20:0xa0b8...`). Run `mm-dev token networks` to see supported chains |
+| `--include-market-data` | No | Include market cap, volume, and price data |
+| `--include-token-security-data` | No | Include token security signals (scam risk, honeypot detection) |
+| `--include-labels` | No | Include token labels and categories |
+| `--include-aggregators` | No | Include aggregator sources that list this token |
+| `--include-coingecko-id` | No | Include the CoinGecko identifier for cross-referencing |
+| `--include-occurrences` | No | Include occurrence count across chains |
+| `--include-rwa-data` | No | Include real-world asset (RWA) data |
 
 ### Example
 
 ```bash
 mm-dev token assets --asset-ids "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,eip155:137/slip44:966"
 mm-dev token assets --asset-ids "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" --include-market-data --include-token-security-data --include-labels
+mm-dev token assets --asset-ids "eip155:1/slip44:60" --include-aggregators --include-coingecko-id --include-rwa-data
 ```

skills/metamask-agent-wallet/references/perps.md

@@ -20,24 +20,26 @@ List perpetual markets for a venue.
 ### Syntax
 
 ```bash
-mm-dev perps markets --venue <venue> [--network <network>] [--symbol <symbol>] [--symbols <list>]
+mm-dev perps markets --venue <venue> [--network <network>] [--symbol <symbol>] [--symbols <list>] [--dex <name>]
 ```
 
 ### Supported Flags
 
 | Name | Required | Description |
 | --- | --- | --- |
-| `--venue` | Yes | Perpetual venue (defaults to `hyperliquid`) |
-| `--network` | No | Target network: `mainnet` or `testnet` (defaults to `mainnet`) |
-| `--symbol` | No | Market symbol (e.g. BTC, ETH, SOL) |
+| `--venue` | Yes | Perpetual venue (defaults to `hyperliquid`). Run `mm-dev perps list-venues` to see options (allowed: `hyperliquid`) |
+| `--network` | No | Target network: `mainnet` or `testnet` (defaults to `mainnet`) (allowed: `mainnet`, `testnet`) |
+| `--symbol` | No | Filter to a single market symbol (e.g. BTC) |
 | `--symbols` | No | Comma-separated market symbols to filter (e.g. BTC,ETH,SOL) |
+| `--dex` | No | HIP-3 DEX name; omit for the main Hyperliquid DEX. Run `mm-dev perps dexs` to see options |
 
 ### Example
 
 ```bash
 mm-dev perps markets --venue hyperliquid
 mm-dev perps markets --venue hyperliquid --symbol BTC
 mm-dev perps markets --venue hyperliquid --symbols BTC,ETH,SOL --network testnet
+mm-dev perps markets --venue hyperliquid --dex myDex
 ```
 
 ## `perps balance` Command
@@ -232,23 +234,27 @@ Cancel a resting perps order.
 ### Syntax
 
 ```bash
-mm-dev perps cancel --venue <venue> --order-id <id> [--network <network>] [--yes] [--password <password>]
+mm-dev perps cancel --venue <venue> --order-id <id> [--symbol <symbol>] [--network <network>] [--dry-run] [--yes] [--password <password>]
 ```
 
 ### Supported Flags
 
 | Name | Required | Description |
 | --- | --- | --- |
-| `--venue` | Yes | Perpetual venue (defaults to `hyperliquid`) |
+| `--venue` | Yes | Perpetual venue (defaults to `hyperliquid`). Run `mm-dev perps list-venues` to see options (allowed: `hyperliquid`) |
 | `--order-id` | Yes | Venue order ID to cancel (positive integer) |
-| `--network` | No | Target network: `mainnet` or `testnet` (defaults to `mainnet`) |
+| `--symbol` | No | Market symbol; speeds up cancel by avoiding an open-order lookup (e.g. BTC, ETH) |
+| `--network` | No | Target network: `mainnet` or `testnet` (defaults to `mainnet`) (allowed: `mainnet`, `testnet`) |
+| `--dry-run` | No | Preview the cancel action without signing or submitting |
 | `--yes` | No | Skip interactive confirmation |
 | `--password` | No | Password to unlock the BYOK mnemonic (BYOK mode only) [env: `MM_PASSWORD`] |
 
 ### Example
 
 ```bash
 mm-dev perps cancel --venue hyperliquid --order-id 12345
+mm-dev perps cancel --venue hyperliquid --order-id 12345 --symbol BTC
+mm-dev perps cancel --venue hyperliquid --order-id 12345 --dry-run
 mm-dev perps cancel --venue hyperliquid --order-id 12345 --yes
 ```
 
@@ -259,25 +265,27 @@ Deposit USDC into a perpetual venue.
 ### Syntax
 
 ```bash
-mm-dev perps deposit --venue <venue> --amount <amount> [--asset <asset>] [--source-chain <chain>] [--network <network>] [--yes] [--password <password>]
+mm-dev perps deposit --venue <venue> --amount <amount> [--asset <asset>] [--source-chain <chain>] [--network <network>] [--dry-run] [--yes] [--password <password>]
 ```
 
 ### Supported Flags
 
 | Name | Required | Description |
 | --- | --- | --- |
-| `--venue` | Yes | Perpetual venue (defaults to `hyperliquid`) |
+| `--venue` | Yes | Perpetual venue (defaults to `hyperliquid`). Run `mm-dev perps list-venues` to see options (allowed: `hyperliquid`) |
 | `--amount` | Yes | Human-readable USDC amount to deposit (e.g. 100, 50.5) |
-| `--asset` | No | Deposit asset (defaults to USDC) |
+| `--asset` | No | Deposit asset (defaults to `USDC`) (allowed: `USDC`) |
 | `--source-chain` | No | Source chain as a CAIP-2 ID. Hyperliquid only supports Arbitrum (defaults to `eip155:42161` on mainnet) |
-| `--network` | No | Target network: `mainnet` or `testnet` (defaults to `mainnet`) |
+| `--network` | No | Target network: `mainnet` or `testnet` (defaults to `mainnet`) (allowed: `mainnet`, `testnet`) |
+| `--dry-run` | No | Preview the transaction without signing or submitting |
 | `--yes` | No | Skip interactive confirmation |
 | `--password` | No | Password to unlock the BYOK mnemonic (BYOK mode only) [env: `MM_PASSWORD`] |
 
 ### Example
 
 ```bash
 mm-dev perps deposit --venue hyperliquid --amount 100 --asset USDC
+mm-dev perps deposit --venue hyperliquid --amount 100 --asset USDC --dry-run
 mm-dev perps deposit --venue hyperliquid --amount 100 --asset USDC --yes
 ```
 
@@ -288,25 +296,28 @@ Withdraw USDC from a perpetual venue.
 ### Syntax
 
 ```bash
-mm-dev perps withdraw --venue <venue> --amount <amount> [--asset <asset>] [--destination <address>] [--network <network>] [--yes] [--password <password>]
+mm-dev perps withdraw --venue <venue> --amount <amount> [--asset <asset>] [--destination <address>] [--network <network>] [--dry-run] [--include-spot] [--yes] [--password <password>]
 ```
 
 ### Supported Flags
 
 | Name | Required | Description |
 | --- | --- | --- |
-| `--venue` | Yes | Perpetual venue (defaults to `hyperliquid`) |
+| `--venue` | Yes | Perpetual venue (defaults to `hyperliquid`). Run `mm-dev perps list-venues` to see options (allowed: `hyperliquid`) |
 | `--amount` | Yes | Human-readable USDC amount to withdraw (e.g. 50, 25.5) |
-| `--asset` | No | Withdraw asset (defaults to USDC) |
+| `--asset` | No | Withdrawal asset (defaults to `USDC`) (allowed: `USDC`) |
 | `--destination` | No | EVM destination address (defaults to your connected wallet) |
-| `--network` | No | Target network: `mainnet` or `testnet` (defaults to `mainnet`) |
+| `--network` | No | Target network: `mainnet` or `testnet` (defaults to `mainnet`) (allowed: `mainnet`, `testnet`) |
+| `--dry-run` | No | Preview the withdrawal without signing or submitting |
+| `--include-spot` | No | Move free spot USDC to perp account before withdrawing if the perp balance alone is insufficient |
 | `--yes` | No | Skip interactive confirmation |
 | `--password` | No | Password to unlock the BYOK mnemonic (BYOK mode only) [env: `MM_PASSWORD`] |
 
 ### Example
 
 ```bash
 mm-dev perps withdraw --venue hyperliquid --amount 50 --asset USDC
+mm-dev perps withdraw --venue hyperliquid --amount 50 --asset USDC --include-spot
 mm-dev perps withdraw --venue hyperliquid --amount 50 --asset USDC --destination 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18 --yes
 ```