# Heurist Mesh: Yahoo Finance Symbol Resolver

> Heurist Mesh: Yahoo Finance Symbol 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-15).

Resolves a company name, ticker fragment, or market term into a valid Yahoo Finance symbol usable by downstream financial tools.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/YahooFinanceAgent/resolve_symbol
- 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-yahoo-finance-symbol-resolver-df491c07
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Vf9BOfYyp9N6AuGIVw5iA

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-yahoo-finance-symbol-resolver-df491c07 -d '<json body>'
```

Example prompt: What's the correct Yahoo Finance symbol for Tesla so I can pull its historical price data?

## When to prefer this

Use this endpoint whenever a downstream Yahoo Finance-based tool requires a precise symbol and the input is a human-readable company name, partial ticker, or ambiguous market term. This is the correct pre-processing step before calling historical price (OHLCV) or other Yahoo Finance data endpoints on Heurist Mesh.

## Known failure modes

- Ambiguous input with no clear match — returns multiple candidates or empty result
- Unknown company name or unsupported market term — returns empty or error response
- Misspelled ticker fragment — may return incorrect or zero matches
- Cryptocurrency or niche instrument not indexed by Yahoo Finance — no result returned

## How this service works

Resolve a company name, ticker fragment, or market term into agent-usable Yahoo Finance symbols. Use this before other tools when the symbol is ambiguous.

## Output

Returns one or more candidate Yahoo Finance symbols matching the input query, suitable for use as parameters in downstream financial data endpoints such as historical price or market summary tools.

## 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": {
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "limit": {
       "type": "integer",
       "default": 5,
       "description": "Maximum number of matches to return."
      },
      "query": {
       "type": "string",
       "description": "Ticker, company name, or market term to resolve."
      },
      "asset_type": {
       "type": "string",
       "description": "Optional asset-type filter."
      }
     }
    },
    "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-yahoo-finance-symbol-resolver-df491c07/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)