# Heurist Mesh: Yahoo Finance Equity Screen

> Heurist Mesh: Yahoo Finance Equity Screen 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).

Runs a curated predefined Yahoo Finance equity screen and returns compact candidate stock rows matching that screen's criteria.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/YahooFinanceAgent/equity_screen
- 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-equity-screen-c16e71f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iYfGkbDkHO3fggxY4MuN1

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-equity-screen-c16e71f5 -d '<json body>'
```

Example prompt: Can you run the most undervalued large-cap equity screen on Yahoo Finance and give me the top candidate stocks from the results?

## When to prefer this

Choose this endpoint when you need a quick, curated list of equity candidates from a well-known Yahoo Finance screen without building custom filter logic. It is ideal for agents doing investment research, portfolio idea generation, or market scanning workflows where Yahoo Finance's predefined screens are sufficient. Prefer this over custom screener APIs when you want opinionated, battle-tested screening criteria out of the box.

## Known failure modes

- Invalid or unsupported screen name returns an error or empty result
- Yahoo Finance data temporarily unavailable causes failure
- Payment of $0.002 USDC not fulfilled triggers 402 response
- Rate limiting if called too frequently in short succession
- Screen returns zero candidates if market conditions don't satisfy criteria

## How this service works

Run one curated predefined Yahoo Finance equity screen and return compact candidate rows.

## Output

Returns compact rows of equity candidates that pass the selected predefined Yahoo Finance screen, typically including ticker symbol, company name, and key financial metrics relevant to the screen's criteria.

## 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": [
      "screen_name"
     ],
     "properties": {
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "description": "Maximum number of screened candidates to return."
      },
      "screen_name": {
       "type": "string",
       "description": "Screen to run. Each returns a ranked candidate list based on Yahoo Finance criteria for that category."
      }
     }
    },
    "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-equity-screen-c16e71f5/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)