# Heurist Mesh Token Profile

> Heurist Mesh Token Profile 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-15).

Fetches detailed token profile and market data including price, pairs, funding rates, and technical indicators for a given cryptocurrency token

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/TokenResolverAgent/token_profile
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-token-profile-6f8b43e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oAbjRcbtW7LOlAvjQtOia

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-profile-6f8b43e4 -d '<json body>'
```

Example prompt: Can you pull up a full token profile for Solana (SOL) — include technical indicators and funding rates since it's a large cap?

## When to prefer this

Use this endpoint when you already know the token's symbol (e.g. BTC, ETH, SOL), its contract address and chain, or its CoinGecko ID. This is the primary tool for fetching rich token market data in a single call, with optional sections for pairs, funding rates, and technical indicators. If the token identity is ambiguous or unknown, use token_search first to disambiguate before calling this endpoint.

## Known failure modes

- Token not found by symbol — disambiguation needed via token_search tool first
- Invalid or unsupported contract address for the specified chain
- Funding rates requested for a non-Binance-listed token
- Technical indicators requested for a non-large-cap token
- Pairs section enabled for a large cap token (not recommended)
- Network or upstream data provider unavailable

## How this service works

Get detailed profile and market data of a token. Identify it by ONE OF: chain+address (for contract tokens) or symbol (for native/well-known tokens) or coingecko_id. Optional sections to return: pairs, funding_rates (Binance-listed large caps only), technical_indicators (large caps only). Use this tool for well-known tokens such as BTC, ETH, SOL, or for tokens that you already know its chain+address or Coingecko ID. Prefer to use Coingecko ID if available. If the token address or coingecko_id is not known, use token_search tool first to get the disambiguated token information. Only enable pairs section if the token is an altcoin or you believe it has a DEX pool (some tokens are only traded on CEXs). Do not enable pairs section for large caps tokens. Only enable funding rates and technical indicators for large caps.

## Output

Returns a structured token profile including token name, symbol, price, market cap, volume, and metadata. Optionally includes DEX trading pairs (for altcoins), Binance funding rates (large caps only), and technical indicators (large caps only).

## 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": [],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain such as ethereum, base, bsc, solana, robinhood"
      },
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "symbol": {
       "type": "string",
       "description": "Ticker symbol like BTC or ETH. Only use this for well-known native tokens."
      },
      "address": {
       "type": "string",
       "description": "Token contract address (use with chain parameter)"
      },
      "include": {
       "type": "array",
       "items": {
        "enum": [
         "pairs",
         "funding_rates",
         "technical_indicators"
        ],
        "type": "string"
       },
       "default": [
        "pairs"
       ]
      },
      "top_n_pairs": {
       "type": "integer",
       "default": 3,
       "maximum": 10,
       "minimum": 1
      },
      "coingecko_id": {
       "type": "string"
      },
      "indicator_interval": {
       "enum": [
        "1h",
        "1d"
       ],
       "type": "string",
       "default": "1d"
      }
     }
    },
    "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/heurist-mesh-token-profile-6f8b43e4/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)