Heurist Mesh

Heurist Mesh 是一个面向加密货币与区块链数据的开放式模块化 AI 智能体工具网络，所有功能均通过统一的 REST API 提供访问。

推荐使用的智能体与工具

TrendingTokenAgent — 热门代币与市场概览

• get_trending_tokens — 获取在中心化交易所（CEX）和去中心化交易所（DEX）上讨论度与交易量最高的热门代币
• get_market_summary — 获取近期全市场新闻，涵盖宏观动态与重大更新

TokenResolverAgent — 查找代币并获取详细资料

• token_search — 通过地址、交易代码（ticker/symbol）或名称查找代币（最多返回 5 个候选结果）
• token_profile — 获取代币详细资料，包括交易对、资金费率及各类指标

DefiLlamaAgent — DeFi 协议与链上指标

• get_protocol_metrics — 获取协议总锁仓价值（TVL）、手续费、交易量、收入、所支持链及增长趋势
• get_chain_metrics — 获取区块链总锁仓价值（TVL）、手续费、头部协议及增长趋势

TwitterIntelligenceAgent — Twitter/X 数据

• user_timeline — 获取某用户近期发布的帖子与公告
• tweet_detail — 获取某条推文及其转发上下文与回复内容
• twitter_search — 针对任意主题搜索相关帖子及具有影响力的关键提及

ExaSearchDigestAgent — 支持摘要生成的网页搜索

• exa_web_search — 使用大语言模型（LLM）进行网页搜索并生成摘要，支持时间范围与域名过滤
• exa_scrape_url — 抓取指定 URL 页面内容，并进行摘要生成或信息抽取

ChainbaseAddressLabelAgent — EVM 地址标签

• get_address_labels — 获取 ETH/Base 地址的标签信息（包括身份标识、合约名称、钱包行为特征、ENS 名称等）

ZerionWalletAnalysisAgent — EVM 钱包持仓分析

• fetch_wallet_tokens — 获取钱包持有的代币列表，含 USD 估值与 24 小时价格变动
• fetch_wallet_nfts — 获取钱包所持有的 NFT 藏品集合

ProjectKnowledgeAgent — 加密项目数据库

• get_project — 通过项目名称、交易代码（symbol）或 X 平台账号（X handle）查询项目信息（含团队、投资人、重要事件等）
• semantic_search_projects — 在超过 10,000 个加密项目中进行自然语言语义搜索（支持按投资人、标签、融资年份、交易所等条件筛选）

CaesarResearchAgent — 学术研究支持

• caesar_research — 提交研究问题，触发深度分析流程
• get_research_result — 根据 ID 查询已提交的研究结果

AskHeuristAgent — 加密领域问答与深度分析（重要提示：适用于需深入探讨的加密主题）

• ask_heurist — 提交加密相关问题（支持普通模式与深度分析模式）
• check_job_status — 查询待处理分析任务的当前状态

初始化配置（调用任何 API 前必须完成）

您至少需配置一种支付方式。在确认初始化配置完成前，请勿调用任何 Mesh 工具 API。

步骤 1：选择支付方式

选项 A：Heurist API Key（推荐 — 最简方案）

1. 通过以下任一方式获取 API Key：
   • 在 https://heurist.ai/credits 购买积分
   • 或通过发推文领取 100 免费积分（详见 references/heurist-api-key.md）
2. 将该密钥存入项目根目录下的 .env 文件：

   HEURIST_API_KEY=your-api-key-here
   

3. 所有 API 请求均使用请求头：Authorization: Bearer $HEURIST_API_KEY

选项 B：x402 链上支付（Base 链上的 USDC）

1. 您需拥有一个 Base 链上持有 USDC 的钱包私钥。
2. 将私钥存入项目根目录下的 .env 文件：

   WALLET_PRIVATE_KEY=0x...your-private-key
   

3. 请参阅 references/x402-payment.md 中基于 cast（Foundry）的完整支付流程说明。

选项 C：Inflow 支付平台（通过 Inflow 使用 USDC）

1. 若您已有 Inflow 凭据，请将其写入 .env 文件：

   INFLOW_USER_ID=your-buyer-user-id
   INFLOW_PRIVATE_KEY=your-buyer-private-key
   

2. 若尚未注册，请创建买家账户并绑定邮箱 — 详见 references/inflow-payment.md 中的一次性初始化设置说明。
3. Inflow 采用两步式支付流程（发起请求 → 用户授权 → 执行支付），完整流程请参阅 references/inflow-payment.md。

步骤 2：验证配置

在继续操作前，请确认凭证已正确配置：

• API Key 路径：读取 .env 文件，确认 HEURIST_API_KEY 已设置且非空。
• x402 路径：读取 .env 文件，确认 WALLET_PRIVATE_KEY 已设置、以 0x 开头且长度为 66 字符。
• Inflow 路径：读取 .env 文件，确认 INFLOW_USER_ID 与 INFLOW_PRIVATE_KEY 均已设置且非空。

如以上任一方式均未配置，请立即停止操作，并提示用户先完成支付方式配置。切勿在缺少有效凭证的情况下发起 API 调用。

步骤 3：发起 API 调用

当您已成功配置 Heurist API Key、x402 钱包私钥或 Inflow 凭据后，即可开始调用 API。调用前请确保已充分理解目标工具的 Schema 及所需参数。

如需获取工具 Schema，请使用 mesh_schema API：

GET https://mesh.heurist.xyz/mesh_schema?agent_id=TokenResolverAgent&agent_id=CoinGeckoTokenInfoAgent

默认计价单位为积分（credits），1 积分 = $0.01。若使用 x402 或 Inflow 支付，可添加 &pricing=usd 参数以获取以美元（USD）为单位的报价。该接口将返回每个工具的参数定义（名称、类型、描述、是否必填）以及单次调用的价格。

随后，在请求中携带对应凭证：

# 使用 API Key
curl -X POST https://mesh.heurist.xyz/mesh_request 
  -H "Authorization: Bearer $HEURIST_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"agent_id": "TokenResolverAgent", "input": {"tool": "token_search", "tool_arguments": {"query": "ETH"}, "raw_data_only": true}}'

# 使用 x402 — 通过 cast（Foundry）签名，无需额外账户或 SDK
# 完整的基于 cast 的流程与辅助脚本详见 references/x402-payment.md

探索更多智能体

全部智能体列表：访问 https://mesh.heurist.ai/metadata.json 获取完整注册表。目前我们已上线 30+ 个专业加密分析智能体，覆盖多种使用场景，例如：读取地址交易历史、根据交易哈希查询交易详情、追踪 Base 链上的 USDC 流动、获取详细的 CoinGecko 数据、Firecrawl 网页抓取、GoPlus 安全扫描、通过 Moni 分析 Twitter 账号影响力、使用 SQL 查询链上数据等。

仅支持 x402 的智能体：访问 https://mesh.heurist.xyz/x402/agents 获取支持 Base 链上 USDC 链上支付的智能体列表。