# tokenomist

This skill reads token unlocks, emissions, and allocation data. Use it when checking supply pressure or vesting events before a trade.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 302 installs · ★ 30
- Author: Starchild-ai-agent
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/tokenomist/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/tokenomist

## What it does

tokenomist lets an agent inspect a token by symbol, name, or identifier. It can return a token overview, cliff events, daily emission figures, and allocation details. A query such as `ARB` is resolved to the service’s canonical token record before the related data is fetched.

The skill uses script mode with `python3` and imports from `exports.py`. Available helpers cover token resolution, combined overviews, unlock events, daily emissions, and allocation summaries or raw allocation data. Date filters accept ISO 8601 values or Unix timestamps.

Requests require `TOKENMIST_API_KEY`. Authentication is sent through the `x-api-key` header, while network calls use `core/http_client.py` and the platform proxy path.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tokenomist/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tokenomist/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tokenomist/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tokenomist/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills tokenomist
```

2. **Manually: put the files in place**
- File: `.github/skills/tokenomist/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path tokenomist
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tokenomist/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill tokenomist -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/tokenomist/SKILL.md

## When to use it
- check a token’s upcoming unlock events
- measure scheduled daily emissions
- inspect allocation buckets and locked amounts
- resolve a symbol to its token record
- request a token overview for a date range

## Example prompts
- Check upcoming unlocks and token amounts for `ARB`.
- Resolve `ENA`, then show its daily emission by date.
- Break down `SUI` allocations and identify locked categories.

## Similar
- [crypto-report](https://affpapa.org/en/nevibecode/skills/crypto-report.md) — skill · 4700 installs
- [llmquant-crypto](https://affpapa.org/en/nevibecode/skills/llmquant-crypto.md) — skill · 502 installs
- [token-economics](https://affpapa.org/en/nevibecode/skills/token-economics.md) — skill · 443 installs
- [Mycelium Emissions Database](https://affpapa.org/en/nevibecode/mcp/mycelium-emissions-database.md) — MCP server
- [okx-dex-market](https://affpapa.org/en/nevibecode/skills/okx-dex-market.md) — skill · 19200 installs
- [gmgn-market](https://affpapa.org/en/nevibecode/skills/gmgn-market.md) — skill · 17900 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 35 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md