用途:查询代币经济数据,包括代币解锁时间线、悬崖解锁事件、每日释放量和分配构成。适用于询问代币解锁计划、cliff 解锁、daily emission 或 allocation breakdown 的场景。
主要能力与接口:代币列表使用 v4(/v4/token/list);分配使用 v2(/v2/allocations);每日释放使用 v2(/v2/daily-emission);解锁事件使用 v4(/v4/unlock/events)。存在多版本时默认使用最新稳定版,除非用户明确要求旧行为。工具包括 tokenmist_token_list(支持关键词过滤与结果上限)、tokenmist_resolve_token(把 id/符号/名称解析为规范 tokenId)、tokenmist_allocations(按 token_id 获取分配,含 trackedAllocationPercentage 与有效百分比回退、top_allocations、覆盖率与质量摘要,可选 include_raw)、tokenmist_allocations_summary(接受 token_id 或 query,自动解析,返回 top_allocations 及覆盖率/质量标记)、tokenmist_daily_emission、tokenmist_unlock_events、tokenmist_token_overview(一次完成解析、分配、每日释放与解锁事件)。
使用方式:请求头使用 x-api-key: $TOKENMIST_API_KEY,基础地址为 https://api.tokenomist.ai,通过 core/http_client.py(proxied_get)走平台 sc-proxy。环境里的假密钥属预期,不要因 fake 前缀判为无效。查询含糊时先调用 resolve_token;综合分析用 token_overview;分配问题优先用 allocations_summary,需要细节再看 normalized.top_allocations、normalized.coverage 字段。日期保持 UTC,格式 YYYY-MM-DD。
限制:unlock-events v4 侧重悬崖解锁,已移除线性开始/挖矿收益类事件;daily-emission v2 与 allocations v2 含 listing method 上下文(INTERNAL/AI/EXTERNAL)。版本不应降级,除非用户明确要求。未提供收费、价格或平台细节,暂未提供。