Heurist Mesh

Heurist Mesh 是一个面向加密货币和区块链数据的模块化 AI 代理工具开放网络。所有功能均可通过统一的 REST API 访问。

推荐的代理和工具

TrendingTokenAgent— 热门代币和市场摘要

• get_trending_tokens— 获取在中心化交易所和去中心化交易所上讨论和交易最热门的代币
• get_market_summary— 获取包含宏观和重大更新的近期全市场新闻

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

• token_search— 通过地址、代码/符号或名称查找代币（最多5个候选）
• token_profile— 获取包含交易对、资金费率和技术指标的详细代币资料

DefiLlamaAgent— DeFi 协议和链上指标

• get_protocol_metrics— 获取协议的总锁定价值、费用、交易量、收入、支持链和增长趋势
• get_chain_metrics— 获取区块链总锁定价值、费用、顶级协议及增长趋势

TwitterIntelligenceAgent— Twitter/X 数据

• user_timeline— 获取用户最近的帖子和公告
• tweet_detail— 获取推文及其线程上下文和回复
• twitter_search— 搜索任何主题的帖子和有影响力的提及

ExaSearchDigestAgent— 带摘要的网页搜索

• exa_web_search— 使用大语言模型摘要、时间和域名过滤器进行网页搜索
• exa_scrape_url— 抓取 URL 并摘要或提取信息

ChainbaseAddressLabelAgent— EVM 地址标签

• get_address_labels— 获取 ETH/Base 地址的标签（身份、合约名称、钱包行为、ENS）

ZerionWalletAnalysisAgent— EVM钱包持仓

• fetch_wallet_tokens— 获取代币持仓及其美元价值与24小时价格变化
• fetch_wallet_nfts— 获取钱包持有的NFT藏品系列

ProjectKnowledgeAgent— 加密项目数据库

• get_project— 通过名称、代号或X账号（团队、投资者、事件）查找项目
• 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密钥（推荐 — 最简单）

1. 通过以下任一方式获取API密钥：
   • 在以下地址购买积分：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. 关于使用cast工具（Foundry框架）的支付流程，请参阅references/x402-payment.md。

选项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：验证设置

• 在继续之前，请检查凭证是否已配置：读取.env并确认HEURIST_API_KEY已设置且非空。
• x402路径：读取.env并确认WALLET_PRIVATE_KEY已设置，以0x开头，并且长度为66个字符。
• Inflow路径：读取.env并确认INFLOW_USER_ID和INFLOW_PRIVATE_KEY已设置且非空。

如果两者均未配置，请停止并提示用户设置支付方式。在没有有效凭证的情况下，请勿进行API调用。

步骤3：进行API调用

一旦您拥有Heurist API密钥、x402钱包私钥或Inflow密钥中的任意一项，即可进行API调用。在调用前，您应当理解工具架构及所需工具的参数。

要获取工具架构，请使用mesh_schemaAPI：

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

默认计费单位为积分。1积分价值0.01美元。在使用x402或Inflow时，添加&pricing=usd参数可获取美元计价而非积分计价。该接口将返回每个工具的参数（名称、类型、描述、必填/可选）及单工具价格。

随后在请求中使用凭证：

# With 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}}'

# With x402 — sign with cast (Foundry), no account or SDK needed
# See references/x402-payment.md for the full cast-based flow and helper script

探索更多智能体

所有智能体：获取https://mesh.heurist.ai/metadata.json查看完整注册表。我们提供30+个专业加密分析智能体，覆盖以下用例：读取地址交易历史、通过哈希值查询交易详情、追踪Base链上USDC、获取详细Coingecko数据、Firecrawl网页抓取、GoPlus安全筛查、通过Moni检查Twitter账户影响力、使用SQL查询区块链数据等。

仅限启用x402的智能体：获取https://mesh.heurist.xyz/x402/agents适用于支持Base链上USDC支付的代理。