mcpField
T
tokenomist

tokenomist

github.com/starchild-ai-agentデータ・データベース30302 回インストール6 日前に更新
リポジトリ

tokenomist について

tokenomist は Tokenomist API を使ってトークンのアンロック時系列を分析するスクリプト型スキルです。トークンの解決、配分、日次発行、アンロックイベントの取得に加え、複合的な概要取得関数を提供します。

主な機能

  1. 01トークン識別子の一覧表示と解決
  2. 02配分データと要約の取得
  3. 03日次発行スケジュールの取得
  4. 04クリフ型アンロックイベントの取得
  5. 05概要関数による複数データの集約

活用シーン

  1. 01トークンの正式な識別子の特定
  2. 02トークン配分区分の要約
  3. 03期間を指定した発行量の確認
  4. 04予定されたクリフ型アンロックの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill tokenomist

インストール後、Claude Code で/tokenomistを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

__init__.py
.gitignore
exports.py
scripts/
test_tokenomist_faq_extended.py
test_tokenomist_tools.py
test_tokenomist.py
tools/
__init__.py
client.py
tokenomist_tools.py

詳細

スクリプトの使用方法

スクリプトモードのスキル — このファイルを読み、bash ブロックから呼び出します:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/tokenomist")
from exports import (
    tokenomist_resolve_token,
    tokenomist_token_overview,
    tokenomist_unlock_events,
    tokenomist_daily_emission,
    tokenomist_allocations,
)

# Resolve symbol -> token id
print(tokenomist_resolve_token(query="ARB"))

# Full overview
print(json.dumps(tokenomist_token_overview(query="ARB"), indent=2))
EOF

exports.py で利用可能な関数: tokenomist_token_list、 tokenomist_resolve_token、tokenomist_allocations、 tokenomist_allocations_summary、tokenomist_daily_emission、 tokenomist_unlock_events、tokenomist_token_overview。 正確なシグネチャについては exports.py を直接参照してください。

Tokenomist (Tokenomist API)

このスキルはトークンアンロックのタイムライン分析に使用します。

関数リファレンス (完全なシグネチャ + 戻り値の形式)

すべての関数は exports.py にあります。

⚠️ フィールド命名規則 (最初にお読みください)

Tokenomist のレスポンスフィールドはすべて camelCase を使用しており、snake_case ではありません。 最も よくある間違い: フィールドが実際には trackedAllocationPercentage であるのに allocation_percentage を 探してしまうことです。スクリプトを書く前に必ず dict を確認してください。

関数シグネチャ
関数シグネチャ
tokenomist_token_list()サポートされているすべてのトークンを一覧表示 (id + symbol + name)
tokenomist_resolve_token(query)dict — {match_type, token: {id, symbol, name, marketCap, ...}, candidates}。"ARB" のようなシンボルを他の呼び出しの前に正規の id "arbitrum" に変換するために使用します (他のほとんどのエンドポイントはどちらも受け付けます)。
tokenomist_allocations(query)完全な生のアロケーションデータ (詳細で、判明している場合は受取人ごとの内訳を含む)
tokenomist_allocations_summary(query)集計されたアロケーションサマリー — 分析/チャートに推奨
tokenomist_daily_emission(query, start=None, end=None)日次のエミッションスケジュール (日付 + 数量)
tokenomist_unlock_events(query, start=None, end=None)クリフアンロックイベントのリスト
tokenomist_token_overview(query, start=None, end=None, include_allocations=True, include_emission=True, include_events=True)複合呼び出し — 概要 + アロケーション + エミッション + イベントを 1 つのレスポンスにまとめます。「トークン X に関するすべてを取得」する場合にこれを使用します。

start / end は ISO 8601 形式の日付 ("2026-01-01") または unix タイムスタンプを受け付けます。「利用可能なすべての履歴」の場合は両方とも省略してください。

レスポンススキーマ

tokenomist_allocations_summary(query="ARB"):

{
  "metadata": {"queryDate": "2026-05-04T..."},
  "status": true,
  "data": {
    "name": "Arbitrum",
    "symbol": "ARB",
    "listedMethod": "INTERNAL",
    "maxSupply": 10000000000,
    "lastUpdatedDate": "2025-06-11T10:31:15Z",
    "totalUnlockedAmount": 5410170736.76,
    "totalLockedAmount": 1186004337.54,
    "totalUntrackedAmount": 0,
    "totalTBDLockedAmount": 3403750000,
    "allocations": [
      {
        "allocationName": "Arbitrum DAO Treasury",
        "allocationType": "TBD",
        "standardAllocationName": "Reserve",
        "allocationUnlockedAmount": 0,
        "allocationLockedAmount": 3403750000,
        "allocationAmount": 3403750000,
        "trackedAllocationPercentage": 34.0375
      },
      ...
    ]
  }
}

allocations 項目でよくある落とし穴:

  • パーセンテージフィールド: trackedAllocationPercentage (allocation_percentage / percentage / pct ではありません)
  • 3 つの別々の数量フィールド: allocationAmount (合計)、allocationUnlockedAmount、allocationLockedAmount
  • タイプフィールド: allocationType — "TBD"、"Scheduled"、"Vested" のような文字列値
  • 標準カテゴリ名: standardAllocationName (例: "Reserve"、"Founder / Team"、"Private Investors")

tokenomist_unlock_events(query="ARB"):

{
  "data": [
    {
      "eventDate": "2026-...",
      "tokenAmount": ...,
      "tokenAmountUSD": ...,
      "allocationName": "Investors",
      "allocationType": "Scheduled"
    }
  ]
}

tokenomist_daily_emission(query="ARB"):

{
  "data": [
    {"date": "2026-...", "amountEmitted": ..., "amountEmittedUSD": ...}
  ]
}

tokenomist_resolve_token(query="ARB"):

{
  "match_type": "exact_symbol",
  "token": {
    "id": "arbitrum",
    "name": "Arbitrum",
    "symbol": "ARB",
    "listedMethod": "INTERNAL",
    "marketCap": 721937871,
    "circulatingSupply": 6150718438,
    "maxSupply": 10000000000
  },
  "candidates": []
}

match_type は "exact_symbol"、"exact_id"、"exact_name"、 "fuzzy"、または "none" のいずれかです。fuzzy の場合、candidates は 曖昧さを解消するための代替トークンを列挙します。

バージョンポリシー (厳格なルール)

複数の API バージョンが存在する場合は、常に最新の安定版を使用してください:

  • Token List API → v4 (/v4/token/list)
  • Allocations API → v2 (/v2/allocations)
  • Daily Emission API → v2 (/v2/daily-emission)
  • Unlock Events API → v4 (/v4/unlock/events)

ユーザーが明示的にレガシー動作を要求しない限り、ダウングレードしないでください。

認証 + プロキシ

  • ヘッダー: x-api-key: $TOKENMIST_API_KEY
  • ベース URL: https://api.tokenomist.ai
  • このスキルは core/http_client.py (proxied_get) を使用するため、リクエストはプラットフォームの sc-proxy の動作に従います。
  • 環境に設定されている偽のキーは想定内です (例: fake-tokenomist-key-12345)。このプラットフォームでは、偽のプレフィックスを無効なものとして扱わないでください。

ツールマップ

tokenomist_token_list

Token List v4 を取得します。オプションのキーワードフィルタリングと結果件数の上限をサポートします。

tokenomist_resolve_token

トークンのクエリ (id/symbol/name) を v4 リストの正規の tokenId に解決します。

tokenomist_allocations

token_id で Allocations v2 を取得します。エージェントでの利用に最適化された正規化済みの出力を備えています：

  • 主要なパーセンテージフィールド：trackedAllocationPercentage
  • 計算によるフォールバック：effectivePercentage
  • top_allocations と coverage の品質サマリーを含みます
  • 上流のペイロードをデバッグするためのオプション include_raw=true
tokenomist_allocations_summary

コンパクトなアロケーションサマリーのラッパー（v2）：

  • token_id または query のいずれかを受け付けます
  • 必要に応じて query を正規の tokenId に自動解決します
  • top_allocations（設定可能な top_n）と coverage / quality フラグを返します
  • ユーザーが「上位のアロケーション内訳」を尋ね、簡潔な1つのレスポンスを返したい場合に最適なデフォルトです
tokenomist_daily_emission

token_id と任意の start/end（YYYY-MM-DD）で Daily Emission v2 を取得します。

tokenomist_unlock_events

token_id と任意の start/end（YYYY-MM-DD）で Unlock Events v4 を取得します。

tokenomist_token_overview

ツール数を削減するワンコールのラッパー：

  1. トークンを解決
  2. allocations v2 を取得
  3. daily emission v2 を取得
  4. unlock events v4 を取得

ユーザーが広範なトークノミクスの概要を尋ね、ツール呼び出しを最小限にしたい場合のデフォルトとして使用してください。

推奨ワークフロー

  1. ユーザーのクエリが曖昧な場合は、まず tokenomist_resolve_token を呼び出します。
  2. 包括的な分析には、tokenomist_token_overview を1回呼び出します。
  3. アロケーション固有の質問には、tokenomist_allocations_summary を優先してください（フィールドが最も少なく、曖昧さも最小です）。
  4. 完全な詳細が必要な場合は、tokenomist_allocations を呼び出し、以下を参照してください：
    • normalized.top_allocations
    • normalized.coverage.tracked_percentage_sum
    • normalized.coverage.tracked_sum_close_to_100
  5. ユーザーが特定の1つのデータセットを尋ねた場合にのみ、詳細なツールを呼び出してください。
  6. 日付は UTC のままにし、YYYY-MM-DD を使用してください。

注意事項

  • unlock-events v4 はクリフアンロックに焦点を当てています（線形の開始／マイニングイールド形式のイベントは削除されています）。
  • daily-emission v2 と allocations v2 には、上場方法のコンテキスト（INTERNAL/AI/EXTERNAL）が含まれます。

コメント

Markdown 対応