# Heurist Mesh Solana Token Resolver

> Heurist Mesh Solana 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-16).

Search Solana tokens by address, symbol, or name and return up to 5 candidate matches with market and trading context

## Facts

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

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 mesh-heurist-xyz-e49514a1 -d '<json body>'
```

Example prompt: Search for Solana tokens matching 'BONK' by symbol and give me up to 5 candidates with their contract addresses and market context.

## When to prefer this

Use this endpoint when you need to resolve a Solana token's contract address from its ticker symbol or name, or verify which token matches a given address. Ideal for DeFi workflows on Solana where token disambiguation is needed before trading or analysis. Prefer this over generic web search when you need structured token metadata from the Solana ecosystem specifically.

## Known failure modes

- No tokens found for the given query — returns empty result set
- Invalid searchType value — returns 400 bad request
- Query string too vague or too short — may return unrelated tokens
- Network or upstream data provider timeout
- Token exists but has no market data available

## 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 candidate Solana tokens matching the query, each with token address, symbol, name, and concise market and trading context such as price and liquidity data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Optional chain hint (e.g., base, ethereum, solana, robinhood). ONLY use this field if you have direct context mentioning the chain. Leave this field blank otherwise."
      },
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "query": {
       "type": "string",
       "description": "0x… (EVM), Solana mint, ticker/symbol or token name. When searching by name, do not add common crypto suffix such as 'protocol' or 'network'"
      },
      "type_hint": {
       "enum": [
        "address",
        "symbol",
        "name"
       ],
       "type": "string",
       "description": "Optional explicit hint for the type of the query"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "object",
       "additionalProperties": true
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mesh-heurist-xyz-e49514a1/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)