核心用法
Token Profiler 是一个轻量化的链上代币信息聚合技能，面向 Solana 和 Base 两条主流公链，通过调用 VerdictSwarm 的公开只读端点 https://api.vswarm.io/v1/token，为 Agent 提供结构化的代币画像数据。使用时仅需传入代币合约地址（Base 为 EVM 格式，Solana 需保留原始大小写）及链标识参数，即可在单次 HTTP GET 请求中获取涵盖市场数据、持有者分布、流动性状况、安全指标、社交链接及 DEX 交易对信息的综合快照。该技能专为发现与初筛场景设计，帮助 Agent 在投入更深度的风险分析前，快速建立对目标代币的基础认知。
显著优点
1. 零成本轻量接入：每日 100 次免费查询额度，无需 API Key 或身份认证，大幅降低链上数据获取门槛。
2. 多维度数据整合：单端点聚合价格、市值、FDV、持有者集中度、合约年龄、流动性深度、权威控制、蜜罐检测、代理合约、黑名单机制、官方社交链接及 DEX 分布等 10+ 维度信息。
3. 明确的速率控制：响应头提供 X-RateLimit-* 字段，便于 Agent 实现优雅的限流处理与 UTC 重置时间提示。
4. 透明的数据来源：meta.sources 字段明确标注数据上游，避免"黑盒"决策。
潜在缺点与局限性
1. 非最终裁决工具：文档明确强调该端点仅用于"筛查"而非"安全判决"，缺失字段不代表通过检测，Agent 不得将其输出直接映射为 avoid/caution/clear 等二元结论。
2. 严格的速率上限：100 次/日的免费额度对高频监控或批量扫描场景严重不足，且不提供付费绕过机制，超限后需等待 UTC 日重置或迁移至 v2 付费 API。
3. 双链支持局限：目前仅支持 Solana 与 Base，未覆盖 Ethereum、Arbitrum、Optimism 等主流 EVM 生态。
4. 缓存时效模糊：响应可能来自缓存，但 cached_at 与 fetched_at 的时间差缺乏明确的业务含义说明，Agent 难以判断数据新鲜度。
5. 上游依赖风险：安全指标（如 honeypot、blacklist）依赖第三方数据源，存在滞后或覆盖不全的可能。
适合的目标群体
- 量化交易 Agent：需在执行策略前快速验证代币基础流动性与价格可信度。
- 风险评估类 Agent：作为多级风控流程的第一道滤网，筛选出值得深入分析的标的。
- 投研自动化工具：批量抓取新上线代币的基础画像，建立监控列表。
- 安全审计辅助：结合合约年龄、权限控制等指标进行初步的红蓝对抗筛查。
使用风险
- 性能风险：免费端点无 SLA 保障，高峰时段可能出现延迟或超时；Agent 需实现合理的重试退避策略，禁止在收到 429 后 tight-loop 重试。
- 数据时效风险：缓存机制可能导致价格、流动性等敏感数据滞后，不适用于高频交易决策。
- 合规与误用风险：该技能输出不构成投资建议，Agent 若将筛查结果直接用于自动化交易执行，可能因信息不完整导致资金损失。
- 依赖项风险：底层依赖
curl二进制，容器化部署时需确保基础镜像包含该工具。