# Ysaere X402 Endpoint Health & Schema Check

> Ysaere X402 Endpoint Health & Schema Check is a paid API for AI agents from api.ysaere.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-18).

Checks whether a paid x402 API endpoint is alive, schema-valid, and safe to pay before an agent commits funds

## Facts

- Endpoint: POST https://api.ysaere.com/v1/intel/x402-endpoint-check?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ysaere-x402-endpoint-health-schema-check-90d18809
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_71CjI4ObTYHqRc6ZRKX7u

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 ysaere-x402-endpoint-health-schema-check-90d18809 -d '<json body>'
```

Example prompt: Before you pay that endpoint at https://api.example.com/v1/paid, can you check whether it's actually alive, what it charges, whether its schema looks real, and whether the DNS and TLS check out — give me a verdict on whether it's safe to call?

## When to prefer this

Use this endpoint when an AI agent is about to pay an unfamiliar or third-party x402 endpoint and needs a pre-flight trust signal — especially when the cost of a bad payment or unreliable endpoint outweighs the $0.005 check cost. Prefer this over blindly calling unknown paid endpoints, particularly in automated workflows where repeated failed payments could accumulate costs. Best suited for agentic pipelines that gate spending on upstream health signals.

## Known failure modes

- Invalid or non-HTTPS URL returns an error before any payment is charged
- Private/internal IP URLs are rejected before payment
- Endpoint that has never been probed returns 'unknown' verdict with no uptime data
- TLS or DNS lookup failures surface as reasons in a 'caution' verdict rather than a hard error
- Endpoint with no schema returns completeness score of 0 rather than failing
- Network timeout reaching Ysaere's own probing infrastructure may cause slow or failed response

## How this service works

Ysaere Agent Paid-Endpoint Check — $0.005 USDC, no account needed. Input: {"url":"https://api.example.com/v1/paid"}. Before your agent pays an x402 endpoint: is it alive (last success, 7-day uptime from our probes), is its schema real (completeness 0–100), what does it charge, and what do its DNS and TLS show. Verdict ok | caution | unknown with reasons — never a safety guarantee. Invalid or private URLs refused before payment. Wallet only.

## Output

Returns a structured report including: whether the endpoint responded successfully in recent probes, its 7-day uptime percentage, timestamp of last successful call, a schema completeness score (0–100), the endpoint's advertised charge, DNS lookup results, TLS certificate details, and an overall verdict of 'ok', 'caution', or 'unknown' with human-readable reasons explaining the classification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "The https:// URL of the paid endpoint to check"
  },
  "stamp": {
   "type": "boolean",
   "description": "Optional. true adds a signed Notary receipt over output_sha512 (+$0.02 USDC). Integrity, not factual truth."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ysaere-x402-endpoint-health-schema-check-90d18809/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ysaere.com](https://www.zero.xyz/host/api.ysaere.com/llms.txt)
