# ForgeMesh Stock Oracle Status

> ForgeMesh Stock Oracle Status 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).

Validates the trustworthiness of an on-chain price feed for a tokenized equity on Robinhood Chain by running staleness, positive-answer, and round-validity checks, returning a single status verdict and per-check detail.

## Facts

- Endpoint: POST https://x402.forgemesh.io/stock-oracle-status
- 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-stock-oracle-status-7fb7f373
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nqY6L0S7sPkJLimYciGq2

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-stock-oracle-status-7fb7f373 -d '<json body>'
```

Example prompt: Before we execute the trade, can you check if the on-chain price oracle for NVDA is currently trustworthy on Robinhood Chain — I need to know if it's stale or has any validity issues?

## When to prefer this

Use this endpoint when an AI agent needs to gate a downstream decision — such as a trade, liquidation, or pricing action — on the freshness and validity of a tokenized equity's on-chain oracle on Robinhood Chain. Prefer this over generic price APIs when you need chain-specific oracle health checks (staleness, round validity, positive price) rather than just a raw price quote.

## Known failure modes

- Unknown or unsupported ticker symbol returns an error or empty result
- Oracle feed not found on Robinhood Chain for the given symbol
- Network or RPC timeout when querying the on-chain price feed
- Malformed symbol input (e.g. special characters) causes a validation error
- Rate limiting or payment failure results in 402 response

## How this service works

Is the on-chain price for a tokenized equity trustworthy right now? Runs staleness, positive-answer, and round-validity checks against the asset's price feed on Robinhood Chain and returns a single status verdict plus per-check detail. For agents that gate downstream decisions on oracle freshness.

## Output

A single status verdict (e.g. valid/invalid/stale) plus individual results for each of the three checks: staleness, positive-answer, and round-validity — giving the agent a clear go/no-go signal on oracle trustworthiness for the requested ticker.

## 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-stock-oracle-status-7fb7f373/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)