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

• 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

• 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

• 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

• exa_web_search — Search the web with LLM summarization, time and domain filters
• exa_scrape_url — Scrape a URL and summarize or extract information

• get_address_labels — Get labels for ETH/Base addresses (identity, contract names, wallet behavior, ENS)

• fetch_wallet_tokens — Get token holdings with USD value and 24h price change
• fetch_wallet_nfts — Get NFT collections held by a wallet

• 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)

• caesar_research — Submit a research query for in-depth analysis
• get_research_result — Retrieve research results by ID

• 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)

• 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)
• Store the key in .env in the project root:

HEURIST_API_KEY=your-api-key-here

• All API calls use Authorization: Bearer $HEURIST_API_KEY

• You need a wallet private key with USDC balance on Base.
• Store the key in .env in the project root:

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

• See references/x402-payment.md for the payment flow using cast (Foundry).

• If you already have Inflow credentials, store them in .env:

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

• If not, create a buyer account and attach email — see references/inflow-payment.md for one-time setup.
• Inflow uses a two-call payment flow (create request → user approves → execute). See 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.

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

Then use the credentials in requests:

# 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.