tokenomist-point-in-timelisted
Install: claude install-skill tokenomist-ai/tokenomist-cli
# Skill: Point-in-Time History
See a token's tokenomics as it was published at a past version: the versions on its timeline, and its allocations, daily emission and cliff unlock events as known at a given instant.
## When to use
- "What did the unlock schedule look like on 2024-01-01?" (backtests must not use data published later)
- "When and how did this token's tokenomics change?"
- Comparing two versions of a token's schedule.
For the **current** data, use the regular commands (`tok allocation detail`, `tok emission daily`, `tok unlock events`) — they include USD values, which point-in-time answers do not.
## Commands
### List versions
```bash
tok pit versions <tokenId> --output json
```
| Option | Description |
|--------|-------------|
| `--start <date>` | Keep versions valid from this day (YYYY-MM-DD) |
| `--end <date>` | Keep versions valid from up to this day (YYYY-MM-DD) |
| `--page <number>` | Page number |
| `--page-size <number>` | Items per page |
Each version has `id`, `historyOrder`, `status` (`current` / `previous`), `validFrom`, `validUntil`, `previousVersionId`, `change` (`category`, `title`, `description`) and `changeReferences` (sources).
### Data at a version
```bash
tok pit allocation <tokenId> --as-of 2024-01-01 --output json
tok pit daily-emission <tokenId> --as-of 2024-01-01 --start 2024-03-01 --end 2024-03-31 --output json
tok pit unlock-events <tokenId> --version-id <id> --output json
```
| Option | Description |
|--------|-------------|
|