tokenomist-cli

CLI tool for the Tokenomist API — query token unlocks, emissions, fundraising, burns, and buybacks from the terminal.

Quick Start

npm install -g @tokenomist-ai/tokenomist-cli
tok auth login
tok token list

Or run without installing:

npx @tokenomist-ai/tokenomist-cli token list

Requirements: Node.js 18+ and a Tokenomist API key — get one at tokenomist.ai.

Authentication

Get an API key from tokenomist.ai and configure it.

tok auth login (recommended)

tok auth login
# Enter your Tokenomist API key: ****

# Or pass directly:
tok auth login --api-key your-api-key

This stores your key in ~/.tokenomist/config.json with restricted file permissions (0600).

Check auth status

tok auth status
# Source:  ~/.tokenomist/config.json
# Key:     tk-t****ab2f

Remove stored key

tok auth logout

Alternative methods

Environment variable

export TOKENOMIST_API_KEY=your-api-key

.env file in project directory

TOKENOMIST_API_KEY=your-api-key

CLI flag (per-command)

tok token list --api-key your-api-key

Resolution order

--api-key flag > TOKENOMIST_API_KEY env var > ~/.tokenomist/config.json

AI Skills

Tokenomist CLI ships with AI coding skills that let agents (Claude Code, Cursor, Windsurf, etc.) query tokenomics data on your behalf.

Install skills

npx skills add tokenomist-ai/tokenomist-cli

Install skills locally (after cloning)

If you've cloned the repo for development, install skills from your local copy:

npx skills add .

This reads the skill definitions from the local .agents/skills/ directory instead of fetching from the registry.

Available skills

| Skill | Description | |-------|-------------| | tokenomist-token-overview | Browse all tracked tokens with market data | | tokenomist-unlock-analysis | Analyze upcoming and historical token unlocks | | tokenomist-emission-report | Daily/weekly emission data with allocation breakdowns | | tokenomist-fundraising-lookup | Fundraising rounds, investors, and valuations | | tokenomist-burn-buyback | Token burn and buyback activity | | tokenomist-allocation-breakdown | Full allocation distribution for a token |

Usage

Token list

tok token list
tok token list --output csv

Unlock events

tok unlock list
tok unlock list --min-market-cap 1000000
tok unlock upcoming
tok unlock events solana --start 2024-01-01 --end 2024-12-31

Investors

tok investor list
tok investor detail <investorId>
tok investor detail <investorId> --is-lead-investor

Fundraising

tok fundraising detail solana
tok fundraising detail solana --output json

Burns

tok burn list
tok burn detail solana --start 2024-01-01

Buybacks

tok buyback list
tok buyback detail solana

Emissions

tok emission daily solana
tok emission weekly solana --start 2024-01-01 --end 2024-06-30

Allocations

tok allocation detail solana

Global Options

| Option | Description | |--------|-------------| | -k, --api-key <key> | Override API key | | -o, --output <format> | Output format: table (default), json, csv | | --base-url <url> | Override API base URL (default: https://api.tokenomist.ai) | | -V, --version | Print version | | -h, --help | Show help |

Development

git clone https://github.com/tokenomist-ai/tokenomist-cli.git
cd tokenomist-cli
npm install
npm run build
npm test

# Link for local testing
npm link
tok --help

License

MIT