$npx -y skills add tokenomist-ai/tokenomist-cli --skill tokenomist-token-overviewGet a summary list of all tracked tokens with market data and supply info. Use when browsing tokens, comparing market caps, or finding which tokens have fundraising/burn/buyback data.
| 1 | # Skill: Token Overview |
| 2 | |
| 3 | Get a summary list of all tracked tokens with market data and supply info. |
| 4 | |
| 5 | ## When to use |
| 6 | |
| 7 | When you need to browse all available tokens, compare market caps, or find which tokens have fundraising/burn/buyback data. |
| 8 | |
| 9 | ## Commands |
| 10 | |
| 11 | ### List all tokens |
| 12 | ```bash |
| 13 | tok token list --output json |
| 14 | ``` |
| 15 | |
| 16 | Options: |
| 17 | | Option | Description | |
| 18 | |--------|-------------| |
| 19 | | `--token-id <ids>` | Filter by token IDs (comma-separated) | |
| 20 | |
| 21 | ### Search tokens |
| 22 | ```bash |
| 23 | tok token search <query> --output json |
| 24 | ``` |
| 25 | |
| 26 | ## Output fields |
| 27 | |
| 28 | | Field | Description | |
| 29 | |-------|-------------| |
| 30 | | `id` | Token ID (use in other commands) | |
| 31 | | `name` | Token name | |
| 32 | | `symbol` | Ticker symbol | |
| 33 | | `marketCap` | Current market cap (USD), null if unavailable | |
| 34 | | `circulatingSupply` | Circulating supply | |
| 35 | | `totalLockedAmount` | Tokens still locked | |
| 36 | | `unlockedAmount` | Tokens already unlocked | |
| 37 | | `hasStandardAllocation` | Whether allocation data exists | |
| 38 | | `hasFundraising` | Whether fundraising data exists | |
| 39 | | `hasBurn` | Whether burn data exists | |
| 40 | | `hasBuyback` | Whether buyback data exists | |
| 41 | |
| 42 | ## Examples |
| 43 | |
| 44 | List all tokens as a table: |
| 45 | ```bash |
| 46 | tok token list |
| 47 | ``` |
| 48 | |
| 49 | Filter by specific tokens: |
| 50 | ```bash |
| 51 | tok token list --token-id solana,aptos --output json |
| 52 | ``` |
| 53 | |
| 54 | Search by name or symbol: |
| 55 | ```bash |
| 56 | tok token search bitcoin --output json |
| 57 | ``` |
| 58 | |
| 59 | Export to CSV: |
| 60 | ```bash |
| 61 | tok token list --output csv > tokens.csv |
| 62 | ``` |
| 63 | |
| 64 | ## Domain Context |
| 65 | |
| 66 | - Token IDs (the `id` field) are the primary identifier used across all commands. Use `token list` to discover them. |
| 67 | - `circulatingSupply` and `unlockedAmount` are different concepts — unlocked tokens may not be circulating (they could be held by the team, locked in DeFi protocols, or otherwise not trading on exchanges). |
| 68 | - Fields like `hasStandardAllocation`, `hasFundraising`, `hasBurn`, `hasBuyback` indicate which data types are available. Check these before querying detail commands to avoid empty results. |
| 69 | |
| 70 | ## Workflow |
| 71 | |
| 72 | - **Start here** to find token slugs before using other commands. |
| 73 | - Use the ID in: `tok unlock events <id>`, `tok emission daily <id>`, `tok allocation detail <id>`, etc. |
| 74 | - Check `has*` boolean fields (visible in `--output json`) to know which data types exist for a token before querying. |
| 75 | |
| 76 | ## Output Size |
| 77 | |
| 78 | The `token list` command returns all tracked tokens (~200+). Use `--output json` and filter programmatically for large datasets. |