CLI

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

Get an API key

Install the CLI

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

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

For Developers

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

For AI Agents

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

For Analysts

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

MCP Server

CLI

Get Started

Features at a Glance

Token Unlock Schedules

Emission Breakdowns

Fundraising Intel

Burns & Buybacks

Supply Allocations

Investor Research

Multiple Output Formats

AI Agent Integration

Common Use Cases

Quick Examples

What’s Next

Getting Started

Command Reference

​Get Started

​Features at a Glance

Token Unlock Schedules

Emission Breakdowns

Fundraising Intel

Burns & Buybacks

Supply Allocations

Investor Research

Multiple Output Formats

AI Agent Integration

​Common Use Cases

​Quick Examples

​What’s Next

Getting Started

Command Reference

Get Started

Features at a Glance

Common Use Cases

Quick Examples

What’s Next