# Hyrule Cloud WHOIS/RDAP Lookup

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

Looks up WHOIS/RDAP registration data for domains, IP addresses, CIDR prefixes, ASNs, or registry entities, returning parsed and optionally raw registry records.

## Facts

- Endpoint: POST https://cloud.hyrule.host/v1/whois/lookup
- Price: $0.005/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-whois-rdap-lookup-d0064a3f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P-AC_FZKM3oeHt07oLnLr

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-whois-rdap-lookup-d0064a3f -d '<json body>'
```

Example prompt: Can you pull the WHOIS record for example.com — I want to see who registered it and which registry it's under, including the parsed data?

## When to prefer this

Choose this endpoint when you need structured WHOIS or RDAP registration data for domains, IPs, prefixes, ASNs, or registry entities and want a unified API that covers all subject types with caching control. It is especially useful for network intelligence workflows, threat investigation, or enriching asset inventories. The pay-per-request USDC model suits agents making ad hoc lookups without a subscription commitment. Prefer this over self-querying raw WHOIS servers when you need parsed output, caching (via max_age_seconds), and consistent response structure across multiple registry types.

## Known failure modes

- Subject not found in any registry — empty or null parsed record
- Invalid subject_type / subject_value combination returns a validation error
- Registry rate-limiting or unreachable WHOIS server causes timeout
- RDAP server returns redacted record — parsed fields present but contact info omitted
- ASN or prefix not delegated — no matching RIR record found
- max_age_seconds set to 0 forces live fetch which may be slower or fail under load

## 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 echoed subject (type and value), a parsed key-value WHOIS/RDAP record (fields vary by registry), the WHOIS server used, the registry name (e.g. Verisign), a redaction flag indicating whether contact data was hidden, optionally the raw WHOIS text, a unique request_id, and a generated_at timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "include_raw": {
   "type": "boolean",
   "title": "Include Raw",
   "default": false
  },
  "subject_type": {
   "enum": [
    "domain",
    "ip",
    "prefix",
    "asn",
    "entity"
   ],
   "type": "string",
   "title": "Subject Type",
   "description": "Registry subject kind: domain, IP, prefix, ASN, or entity"
  },
  "subject_value": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "integer"
    }
   ],
   "title": "Subject Value",
   "description": "Domain, IP address, CIDR prefix, ASN, or entity handle"
  },
  "max_age_seconds": {
   "type": "integer",
   "title": "Max Age Seconds",
   "default": 86400,
   "maximum": 2592000,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "parsed": {},
  "server": "whois.verisign-grs.com",
  "subject": {
   "type": "domain",
   "value": "example.com"
  },
  "redacted": true,
  "registry": "Verisign",
  "request_id": "whois_a1b2c3d4",
  "generated_at": "2026-07-15T00:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyrule-cloud-whois-rdap-lookup-d0064a3f/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)