# Hyrule Cloud Proxied HTTP Request

> Hyrule Cloud Proxied HTTP Request is a paid API for AI agents from cloud.hyrule.host, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches any HTTP/HTTPS URL via configurable proxy routing (direct, Tor, I2P, or Yggdrasil) and returns the response body, headers, and status code

## Facts

- Endpoint: POST https://cloud.hyrule.host/v1/network/request
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyrule-cloud-proxied-http-request-f04749c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NhheNvYlOKVb2OqlWA5Ut

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 hyrule-cloud-proxied-http-request-f04749c5 -d '<json body>'
```

Example prompt: Fetch the contents of https://check.torproject.org through Tor with a 30-second timeout and tell me what the response body says.

## When to prefer this

Choose this endpoint when an AI agent needs to fetch arbitrary URLs over privacy-preserving or alternative networks (Tor, I2P, Yggdrasil) that standard HTTP clients cannot reach, or when clearnet requests must be proxied through a neutral third-party network node. Particularly valuable for anonymous web access, accessing .onion or .i2p addresses, or making outbound requests from a consistent RIPE-registered IPv6 address on AS215932.

## Known failure modes

- Timeout if target URL does not respond within the configured timeout_seconds (max 60s)
- Tor/I2P/Yggdrasil nodes unavailable causing routing failure
- Target URL returns non-2xx status (still returned, not thrown as error)
- Invalid or malformed URL rejected before dispatch
- Network-level errors (DNS failure, connection refused) surfaced in error field
- Payment failure via x402 if USDC balance is insufficient

## How this service works

Full-stack network infrastructure for AI agents on AS215932 (RIPE): IPv6-native VMs with SSH and automatic HTTPS subdomains, domain registration and DNS, a broad network-intelligence suite (BGP/routing, IP/ASN & reputation, DNS, RDAP/WHOIS, web & deep TLS, mail deliverability, port/NAT/CGNAT, VoIP/SIP), and proxied requests over Direct/Tor/I2P/Yggdrasil. Pay per request in USDC on Base via x402; VM checkout may also accept BTC/XMR when advertised. This OpenAPI document intentionally contains only the launch-ready, independently payable agent surface.

## Output

A JSON object containing the HTTP status code, response headers as key-value pairs, the full response body as a string, elapsed request time in seconds, and the proxy mode that was used. Error details are included if the request failed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "title": "Url",
   "maxLength": 2048,
   "description": "The full URL to fetch"
  },
  "body": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 65536
    },
    {
     "type": "null"
    }
   ],
   "title": "Body",
   "default": null,
   "description": "Request body"
  },
  "method": {
   "type": "string",
   "title": "Method",
   "default": "GET",
   "description": "HTTP method: GET, HEAD, or POST"
  },
  "headers": {
   "anyOf": [
    {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    {
     "type": "null"
    }
   ],
   "title": "Headers",
   "default": null,
   "description": "Custom headers"
  },
  "proxy_mode": {
   "enum": [
    "direct",
    "tor",
    "i2p",
    "yggdrasil"
   ],
   "type": "string",
   "title": "ProxyMode",
   "default": "direct",
   "description": "Routing mode"
  },
  "timeout_seconds": {
   "type": "integer",
   "title": "Timeout Seconds",
   "default": 15,
   "maximum": 60,
   "minimum": 1,
   "description": "Request timeout"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "body": "<html>…</html>",
  "headers": {
   "content-type": "text/html"
  },
  "proxy_mode": "direct",
  "status_code": 200,
  "elapsed_seconds": 0.12
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyrule-cloud-proxied-http-request-f04749c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cloud.hyrule.host](https://www.zero.xyz/host/cloud.hyrule.host/llms.txt)