# ForgeMesh Price Feed Health Check

> ForgeMesh Price Feed Health Check is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Monitors the freshness and validity of Chainlink-style oracle price feeds for tokenized stocks and ETFs, reporting round data, timestamps, and staleness flags for a given ticker symbol.

## Facts

- Endpoint: POST https://x402.forgemesh.io/price-feed-health-check
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-price-feed-health-check-5e03b9ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UMQXEPKjakjUvAVqpjTLh

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 forgemesh-price-feed-health-check-5e03b9ce -d '<json body>'
```

Example prompt: Can you check the oracle price feed health for NVDA — I need to know if the latest round data is fresh, whether the answer is valid, and how old the last update is compared to the heartbeat?

## When to prefer this

Use this endpoint when you need to programmatically audit the health and freshness of oracle price feeds for tokenized equities or ETFs — especially before executing trades or financial logic that depends on on-chain price data. Prefer this over generic price APIs when you need raw round metadata, heartbeat comparison, and explicit staleness/validity flags rather than just a price quote.

## Known failure modes

- Unknown or unsupported ticker symbol returns an error or empty result
- Feed data unavailable if the underlying oracle contract is unreachable
- Sequencer uptime check explicitly reported as unverifiable rather than failing silently
- Network timeout if the on-chain data source is slow to respond
- Invalid input format for symbol field returns a validation error

## How this service works

Oracle freshness monitor for tokenized stocks and ETFs: reports the age of the latest price update against the feed's heartbeat, flags non-positive or invalid rounds, and states plainly when a check (like sequencer uptime) cannot be verified. Raw round id, answer, and timestamps included for independent auditing.

## Output

Returns the raw round ID, price answer, published and updated timestamps, calculated age of the latest update relative to the feed's heartbeat interval, a staleness flag if the data is too old, and flags for non-positive or invalid round answers. Also notes when certain checks like sequencer uptime cannot be verified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string",
   "description": "Ticker symbol, e.g. AAPL, NVDA, SPY (case-insensitive)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "found": true,
  "round": {
   "age_seconds": 512,
   "heartbeat_seconds": 86400
  },
  "checks": {
   "freshness": "fresh",
   "round_valid": true,
   "sequencer_up": "unsupported",
   "answer_positive": true
  },
  "status": "healthy",
  "symbol": "NVDA"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-price-feed-health-check-5e03b9ce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)