# Hyrule Cloud RDAP Lookup

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

Performs RDAP (Registration Data Access Protocol) lookups for domains, IP addresses, CIDR prefixes, ASNs, and entity handles, returning structured parsed registration data.

## Facts

- Endpoint: POST https://cloud.hyrule.host/v1/rdap/lookup
- Price: $0.003/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-rdap-lookup-65c8d583
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LNsXmUp7A6RARU60l_Mvc

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-rdap-lookup-65c8d583 -d '<json body>'
```

Example prompt: Can you do an RDAP lookup on the domain example.com and tell me the registry and parsed registration details?

## When to prefer this

Choose this endpoint when you need structured, machine-readable RDAP data (the modern successor to WHOIS) for domains, IPs, prefixes, ASNs, or entity handles, especially when you want normalized parsed output alongside optional raw registry responses. Prefer over plain WHOIS lookups when you need consistent JSON structure across multiple registries. Useful for network intelligence pipelines, threat research, and IP/domain attribution where per-request micropayment via USDC on Base is acceptable.

## Known failure modes

- Subject not found in any RDAP registry — returns empty or null parsed result
- Invalid subject type or malformed value (e.g. bad CIDR notation) — request validation error
- Registry timeout or unavailability — upstream RDAP server unreachable
- Stale cache served if max_age_seconds allows it — data may not be real-time fresh
- Payment failure via x402/USDC — request rejected before processing

## 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

Returns a structured JSON object containing a parsed RDAP record (with fields varying by subject type, e.g. registrar, nameservers, dates for domains; or organization, network range, status for IPs/ASNs), the registry name (e.g. Verisign, ARIN, RIPE), the bootstrap URL used, a unique request_id, and a generated_at timestamp. Optionally includes raw RDAP response if include_raw is true.

## 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": {},
  "subject": {
   "type": "domain",
   "value": "example.com"
  },
  "registry": "Verisign",
  "request_id": "rdap_a1b2c3d4",
  "generated_at": "2026-07-15T00:00:00Z"
 }
}
```

## More

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