Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tokenomist.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Tokenomist CLI is currently in beta (v0.1.0). Commands and output formats may change in future releases.
The Tokenomist CLI (tok) gives you direct access to the Tokenomist API from your terminal. Query token unlocks, emissions, fundraising rounds, burns, buybacks, and supply allocations — all without leaving your workflow.

​
Get Started

1

Get an API key

Sign up or log in at tokenomist.ai and generate an API key from your dashboard.
2

Install the CLI

npm install -g @tokenomist-ai/tokenomist-cli
3

Authenticate

tok auth login

​
Features at a Glance

Token Unlock Schedules

Track upcoming and historical unlock events across 300+ tokens.

Emission Breakdowns

Daily and weekly emission data with allocation-level granularity.

Fundraising Intel

Funding rounds, lead investors, valuations, and raise amounts.

Burns & Buybacks

Deflationary mechanism tracking — burns, buybacks, and net supply changes.

Supply Allocations

Full distribution breakdown: team, investors, community, reserves.

Investor Research

Browse investor portfolios and filter by funding activity.

Multiple Output Formats

table, json, and csv — pipe data anywhere.

AI Agent Integration

Pre-built skills for Claude Code, Cursor, Windsurf, and other AI agents.

​
Common Use Cases

  • Pipe JSON output to scripts and CI/CD pipelines with -o json
  • Export data as CSV for downstream processing with -o csv
  • Use tok schema for machine-readable command discovery
  • Automatic retry with exponential backoff on transient failures
# Get unlock events as JSON for scripting
tok unlock events solana -o json | jq '.[] | .cliffValue'

# Export daily emissions to CSV
tok emission daily arbitrum -o csv > arbitrum-emissions.csv
  • Install 6 pre-built skills with npx skills add tokenomist-ai/tokenomist-cli
  • Structured JSON output ready for LLM consumption via -o json
  • Self-documenting — tok schema exposes the full command tree
  • Works with Claude Code, Cursor, Windsurf, and any agent that runs shell commands
# Install AI skills
npx skills add tokenomist-ai/tokenomist-cli

# Get structured data for LLM analysis
tok fundraising detail solana -o json
  • Formatted tables for quick terminal lookups
  • Filter unlocks by market cap, date range, allocation type, or value-to-market-cap ratio
  • Export any dataset to CSV for Excel or Google Sheets
  • Built-in 10-minute cache for fast repeated queries
# Find large upcoming unlocks
tok unlock upcoming --min-value-to-market-cap 0.01

# Compare allocations across tokens
tok allocation detail solana -o csv > solana.csv
tok allocation detail arbitrum -o csv > arbitrum.csv

​
Quick Examples

# List all tracked tokens
tok token list

# Find upcoming unlocks worth >1% of market cap
tok unlock upcoming --min-value-to-market-cap 0.01

# Get daily emissions for Arbitrum this month
tok emission daily arbitrum --start 2024-08-01 --end 2024-08-31

# Export fundraising data as CSV
tok fundraising detail uniswap --output csv > uniswap-fundraising.csv

# Check who invested in a token
tok fundraising detail solana --output json

​
What’s Next

Getting Started

Install, authenticate, and run your first command.

Command Reference

Every command, option, and flag — with examples.