# SupremeAI URL Health Check

> SupremeAI URL Health Check is a paid API for AI agents from agents.supremeai.ca, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Probes a public HTTP(S) URL and returns its availability status (up/down), HTTP status code, and response latency in milliseconds

## Facts

- Endpoint: POST https://agents.supremeai.ca/v1/health-check?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/supremeai-url-health-check-76e0cf62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dAX1UtReUcUDUhWQXMmE6

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 supremeai-url-health-check-76e0cf62 -d '<json body>'
```

Example prompt: Before we call that paid weather API, can you ping https://api.weather.example.com/v1/forecast to make sure it's up and responding quickly — I don't want to waste money if it's down?

## When to prefer this

Use this endpoint when you need a cheap ($0.003) pre-flight check before invoking a more expensive or side-effecting API, especially paid x402 services. It is ideal when you want to avoid wasting credits or money on a downstream service that may be unavailable. Prefer this over a full API call when all you need is a binary up/down signal and response time, not actual data.

## Known failure modes

- Target URL is unreachable or DNS fails — returns down status with no HTTP code
- Target URL is not a public internet address (private IP, localhost) — rejected with validation error
- Malformed or non-HTTP(S) URL provided — input validation error
- Target server responds with a timeout — latency may be null or capped
- Network errors from the probe host itself — may return ambiguous down status

## How this service works

Pay-per-call tools for AI agents: x402 pre-flight checks (is this endpoint safe to pay?), web pages as clean markdown (with optional JavaScript rendering), Latin American tax-ID validation, npm/PyPI/GitHub lookups, and URL health checks. No API keys, no accounts — pay per request in USDC.

## Output

Returns whether the target URL is up or down, the HTTP status code returned by the server, and the round-trip latency in milliseconds. This allows agents to make informed decisions about whether to proceed with a subsequent (potentially paid) API call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "absolute http(s) URL"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "up": true,
  "url": "https://example.com",
  "status": 200,
  "latency_ms": 42
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/supremeai-url-health-check-76e0cf62/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.supremeai.ca](https://www.zero.xyz/host/agents.supremeai.ca/llms.txt)