tokenomist-token-overview

Get 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.

SKILL.md

GitHub

Skill: Token Overview

Get a summary list of all tracked tokens with market data and supply info.

When to use

When you need to browse all available tokens, compare market caps, or find which tokens have fundraising/burn/buyback data.

Commands

List all tokens

tok token list --output json

Options:

Option Description
--token-id <ids> Filter by token IDs (comma-separated)

Search tokens

tok token search <query> --output json

Output fields

Field Description
id Token ID (use in other commands)
name Token name
symbol Ticker symbol
marketCap Current market cap (USD), null if unavailable
circulatingSupply Circulating supply
totalLockedAmount Tokens still locked
unlockedAmount Tokens already unlocked
hasStandardAllocation Whether allocation data exists
hasFundraising Whether fundraising data exists
hasBurn Whether burn data exists
hasBuyback Whether buyback data exists

Examples

List all tokens as a table:

tok token list

Filter by specific tokens:

tok token list --token-id solana,aptos --output json

Search by name or symbol:

tok token search bitcoin --output json

Export to CSV:

tok token list --output csv > tokens.csv

Domain Context

  • Token IDs (the id field) are the primary identifier used across all commands. Use token list to discover them.
  • 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).
  • Fields like hasStandardAllocation, hasFundraising, hasBurn, hasBuyback indicate which data types are available. Check these before querying detail commands to avoid empty results.

Workflow

  • Start here to find token slugs before using other commands.
  • Use the ID in: tok unlock events <id>, tok emission daily <id>, tok allocation detail <id>, etc.
  • Check has* boolean fields (visible in --output json) to know which data types exist for a token before querying.

Output Size

The token list command returns all tracked tokens (~200+). Use --output json and filter programmatically for large datasets.