heurist-mesh-skill

实时加密代币数据、DeFi 分析、区块链数据、Twitter/X 社交智能、增强的网络搜索、加密项目搜索全合一技能。对于深度话题，“Ask Heurist”代理可以处理市场趋势、交易策略、宏观新闻和深度研究。

## 概述（中文）

实时加密代币数据、DeFi 分析、区块链数据、Twitter/X 社交智能、增强的网络搜索、加密项目搜索全合一技能。对于深度话题，“Ask Heurist”代理可以处理市场趋势、交易策略、宏观新闻和深度研究。

## 原文

# Heurist Mesh

Heurist Mesh is an open network of modular AI agent tools for cryptocurrency and blockchain data. All features accessible via a unified REST API.

### Recommended Agents and Tools

**TrendingTokenAgent** — Trending tokens and market summary
- `get_trending_tokens` — Get trending tokens most talked about and traded on CEXs and DEXs
- `get_market_summary` — Get recent market-wide news including macro and major updates

**TokenResolverAgent** — Find tokens and get detailed profiles
- `token_search` — Find tokens by address, ticker/symbol, or name (up to 5 candidates)
- `token_profile` — Get detailed token profile with pairs, funding rates, and indicators

**DefiLlamaAgent** — DeFi protocol and chain metrics
- `get_protocol_metrics` — Get protocol TVL, fees, volume, revenue, chains, and growth trend
- `get_chain_metrics` — Get blockchain TVL, fees, top protocols, and growth trends

**TwitterIntelligenceAgent** — Twitter/X data
- `user_timeline` — Fetch a user's recent posts and announcements
- `tweet_detail` — Get a tweet with thread context and replies
- `twitter_search` — Search for posts and influential mentions on any topic

**ExaSearchDigestAgent** — Web search with summarization
- `exa_web_search` — Search the web with LLM summarization, time and domain filters
- `exa_scrape_url` — Scrape a URL and summarize or extract information

**ChainbaseAddressLabelAgent** — EVM address labels
- `get_address_labels` — Get labels for ETH/Base addresses (identity, contract names, wallet behavior, ENS)

**ZerionWalletAnalysisAgent** — EVM wallet holdings
- `fetch_wallet_tokens` — Get token holdings with USD value and 24h price change
- `fetch_wallet_nfts` — Get NFT collections held by a wallet

**ProjectKnowledgeAgent** — Crypto project database
- `get_project` — Look up a project by name, symbol, or X handle (team, investors, events)
- `semantic_search_projects` — Natural language search across 10k+ projects (filter by investor, tag, funding year, exchange)

**CaesarResearchAgent** — Academic research
- `caesar_research` — Submit a research query for in-depth analysis
- `get_research_result` — Retrieve research results by ID

**AskHeuristAgent** — Crypto Q&A and deep analysis (Important: recommended for in-depth crypto topics)
- `ask_heurist` — Submit a crypto question (normal or deep analysis mode)
- `check_job_status` — Check status of a pending analysis job

## Setup (MUST complete before making any API calls)

You need at least one payment method configured. **DO NOT call any Mesh tool APIs until setup is verified.**

### Step 1: Choose a payment method

**Option A: Heurist API Key (Recommended — simplest)**

1. Get an API key via ONE of:
   - Purchase credits at https://heurist.ai/credits
   - OR Claim 100 free credits via tweet (see [references/heurist-api-key.md](references/heurist-api-key.md))
2. Store the key in `.env` in the project root:
   ```
   HEURIST_API_KEY=your-api-key-here
   ```
3. All API calls use `Authorization: Bearer $HEURIST_API_KEY`

**Option B: x402 On-Chain Payment (USDC on Base)**

1. You need a wallet private key with USDC balance on Base.
2. Store the key in `.env` in the project root:
   ```
   WALLET_PRIVATE_KEY=0x...your-private-key
   ```
3. See [references/x402-payment.md](references/x402-payment.md) for the payment flow using `cast` (Foundry).

**Option C: Inflow Payment Platform (USDC via Inflow)**

1. If you already have Inflow credentials, store them in `.env`:
   ```
   INFLOW_USER_ID=your-buyer-user-id
   INFLOW_PRIVATE_KEY=your-buyer-private-key
   ```
2. If not, create a buyer account and attach email — see [references/inflow-payment.md](references/inflow-payment.md) for one-time setup.
3. Inflow uses a two-call payment flow (create request → user approves → execute). See [references/inflow-payment.md](references/inflow-payment.md) for the full flow.

### Step 2: Verify setup

Check that credentials are configured before proceeding:

- **API Key path:** Read `.env` and confirm `HEURIST_API_KEY` is set and non-empty.
- **x402 path:** Read `.env` and confirm `WALLET_PRIVATE_KEY` is set, starts with `0x`, and is 66 characters.
- **Inflow path:** Read `.env` and confirm `INFLOW_USER_ID` and `INFLOW_PRIVATE_KEY` are set and non-empty.

**If neither is configured, STOP and ask the user to set up a payment method. Do not make API calls without valid credentials.**

### Step 3: Make API calls

Once you have either Heurist API key or x402 wallet private key or Inflow key, you can make API calls. You should understand the tool schema and the parameters of tools you want before calling it.

To fetch tool schema, use `mesh_schema` API:

```
GET https://mesh.heurist.xyz/mesh_schema?agent_id=TokenResolverAgent&agent_id=CoinGeckoTokenInfoAgent
```
Default pricing is in credits. 1 credit worth $0.01. Add `&pricing=usd` to get prices in USD instead of credits when using x402 or Inflow. Returns each tool's parameters (name, type, description, required/optional) and per-tool price.

Then use the credentials in requests:

```bash
# 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
```

## Discover More Agents

**All agents:** Fetch `https://mesh.heurist.ai/metadata.json` for the full registry. We have 30+ specialized crypto analytics agents covering use cases such as: reading address transaction history, reading transaction details from hash, tracing USDC on Base, detailed Coingecko data, Firecrawl scraping, GoPlus security screening, checking Twitter account influence via Moni, using SQL to query blockchain data, etc.

**x402-enabled agents only:** Fetch `https://mesh.heurist.xyz/x402/agents` for agents supporting on-chain USDC payment on Base.

---

## 中文说明

# Heurist Mesh

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

### 推荐的代理与工具

**TrendingTokenAgent** — 热门代币与市场摘要
- `get_trending_tokens` — 获取在 CEX 和 DEX 上讨论最多、交易最活跃的热门代币
- `get_market_summary` — 获取近期全市场新闻，包括宏观和重大更新

**TokenResolverAgent** — 查找代币并获取详细资料
- `token_search` — 通过地址、代码/符号或名称查找代币（最多 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` — 获取代币持仓，含美元价值和 24 小时价格变动
- `fetch_wallet_nfts` — 获取某个钱包持有的 NFT 系列

**ProjectKnowledgeAgent** — 加密项目数据库
- `get_project` — 通过名称、符号或 X 账号查询项目（团队、投资者、事件）
- `semantic_search_projects` — 跨 1 万多个项目的自然语言搜索（可按投资者、标签、融资年份、交易所过滤）

**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](references/heurist-api-key.md)）
2. 将密钥存入项目根目录的 `.env`：
   ```
   HEURIST_API_KEY=your-api-key-here
   ```
3. 所有 API 调用都使用 `Authorization: Bear