# ForgeMesh Utility Grid — Daily Featured Route Discovery

> ForgeMesh Utility Grid — Daily Featured Route Discovery is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns the deterministically rotated featured API route for a given UTC date, including its description, pricing, input schema, and a try-it hint from the ForgeMesh Utility Grid fleet of 547+ routes.

## Facts

- Endpoint: POST https://x402.forgemesh.io/the-daily-402
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-utility-grid-daily-featured-route-discovery-bf07672c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_siVmSD7pIIT3lE-2B452T

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-utility-grid-daily-featured-route-discovery-bf07672c -d '<json body>'
```

Example prompt: What's the featured ForgeMesh Utility Grid API for today — show me its route, price, description, and an example of how to call it.

## When to prefer this

Use this endpoint when an AI agent needs to discover what utility APIs are available in the ForgeMesh Utility Grid, wants a rotating daily introduction to one of 547+ routes, or needs to programmatically browse the x402 ecosystem before committing to a specific utility call. It is not suitable for directly invoking a specific utility capability — use the featured route's own endpoint for that.

## Known failure modes

- Invalid date format returns an error (must be YYYY-MM-DD)
- Future dates beyond the catalog generation window may return unexpected results
- 402 payment challenge must be settled with a valid x402 client before the response is returned
- If the x402 payment fails or is underfunded, the result is not returned
- The featured route itself may be temporarily unavailable even if the discovery call succeeds

## How this service works

A daily rotating spotlight on one paid x402 endpoint from the ForgeMesh fleet: what it does, what it costs, its input schema, a sample response, and the exact call to make. Deterministic by UTC date, so agents and humans checking on the same day see the same pick. Optional date parameter (YYYY-MM-DD) previews past or future days. One call, one new capability discovered.

## Output

Returns a JSON object containing: the featured route's host, path, HTTP method, price in USDC, category, product name, description, and input schema; a try-it hint with a bare POST URL to trigger the 402 challenge; the pool size (total routes in the fleet); catalog generation timestamp; rotation logic explanation; and a link to fetch the full product sheet.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "description": "Optional: preview a specific UTC day's pick, format YYYY-MM-DD. Defaults to today."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-07-18",
  "try_it": "POST https://x402.forgemesh.io/recent-earthquakes — the first bare call returns HTTP 402 with exact USDC payment requirements (Base mainnet); settle with any x402 client and retry to get the data.",
  "featured": {
   "host": "x402.forgemesh.io",
   "price": "$0.005",
   "route": "/recent-earthquakes",
   "method": "POST",
   "category": "utility-grid",
   "product_id": "utility-grid",
   "description": "Recent earthquakes API: latest global quakes above your magnitude threshold from a real-time seismic feed…",
   "input_schema": {
    "type": "object",
    "properties": {
     "min_magnitude": {
      "type": "string",
      "description": "Minimum magnitude, default 4"
     }
    }
   },
   "product_name": "ForgeMesh Utility Grid",
   "example_output": {
    "data": {
     "type": "FeatureCollection"
    },
    "attribution": "U.S. Geological Survey (public domain)"
   }
  },
  "rotation": "deterministic by UTC date — same date always returns the same pick; every route in the fleet gets its day",
  "pool_size": 547,
  "full_product_sheet": "POST https://x402.forgemesh.io/fleet-product-detail ($0.05) with {\"product\":\"utility-grid\"} for every route, schema, and worked example on ForgeMesh Utility Grid.",
  "catalog_generated_at": "2026-07-18T16:21:11.232Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-utility-grid-daily-featured-route-discovery-bf07672c/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)
