# Heurist Mesh Token Resolver

> Heurist Mesh Token Resolver is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Search for cryptocurrency tokens by contract address, ticker symbol, or name and return up to 5 candidates with basic market and trading context

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/agents/TokenResolverAgent/token_search
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-token-resolver-c6082aa9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fZGQj-yNv6g7LhboF7jhH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability heurist-mesh-token-resolver-c6082aa9 -d '<json body>'
```

Example prompt: Can you look up the token 'PEPE' for me and tell me which one has the largest market cap and volume — I want to make sure I have the right contract address and not some scam copy?

## When to prefer this

Use this endpoint when you need to resolve an unfamiliar, new, or ambiguous cryptocurrency token to its on-chain identity and basic market context — especially when you have only a ticker symbol or partial name and need to confirm the correct asset. Prefer this over general web search when you need structured token metadata with market cap and volume data for disambiguation.

## Known failure modes

- No tokens found matching the query — returns empty candidates list
- Query matches only scam tokens with no legitimate trading volume
- Multiple tokens share identical names/symbols requiring manual disambiguation
- Contract address not recognized on any supported chain
- Payment failure due to insufficient USDC balance for x402 micropayment

## How this service works

Find tokens by address, ticker/symbol, or token name. Returns up to 5 concise candidates with basic market/trading context. Use this tool for searching new tokens, unfamiliar tokens, or ambiguous queries. Do not search for multiple assets with one search query. This tool may return multiple assets with the same or similar name/symbol, and in this case you should identify the asset with largest market cap / volume or liquidity to identify the probable asset and ignore the others. The result might include scam tokens (indicated by higher-than-usual market cap with very low volume), which is totally normal and you should ignore them without reporting as errors.

## Output

Returns up to 5 token candidates matching the query, each with basic identifying information (name, symbol, contract address) and market/trading context such as market cap, volume, and liquidity. May include scam tokens with abnormally high market cap relative to volume, which should be disregarded.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-token-resolver-c6082aa9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)