# Hyrule Cloud DNS Lookup

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

Performs DNS record lookups for a given domain name, supporting all major record types with optional DNSSEC validation, custom resolver, and query tracing.

## Facts

- Endpoint: POST https://cloud.hyrule.host/v1/dns/lookup
- Price: $0.001/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-dns-lookup-9ad52691
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gUGm0c12azWGEbeKAmc5e

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-dns-lookup-9ad52691 -d '<json body>'
```

Example prompt: Look up the MX records for gmail.com using DNSSEC validation and give me the full answer set with TTLs.

## When to prefer this

Choose this endpoint when you need programmatic DNS resolution with support for DNSSEC validation, custom resolvers, or query tracing — particularly within an AI agent workflow that already pays per request in USDC via x402. It is especially suitable when you need detailed structured output (TTLs, authority, additional sections) rather than a simple string answer, or when you want to trace the full DNS delegation path.

## Known failure modes

- NXDOMAIN returned when domain does not exist
- SERVFAIL if the upstream resolver fails or times out
- Timeout error if resolution exceeds timeout_ms limit
- DNSSEC validation failure if chain is broken or unsigned
- Empty answers array for valid domain with no records of requested type
- Invalid record type enum value causes request validation error
- Name too long (>253 chars) or empty causes schema validation failure

## 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 DNS response including the RCODE (e.g. NOERROR, NXDOMAIN), an array of answer records (each with name, type, value, and TTL), authority and additional sections, DNSSEC validation status and chain detail, optional trace hops, the resolver used, the original question, a unique request_id, and a generated_at timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "title": "Name",
   "maxLength": 253,
   "minLength": 1
  },
  "type": {
   "enum": [
    "A",
    "AAAA",
    "CAA",
    "CNAME",
    "DNSKEY",
    "DS",
    "MX",
    "NAPTR",
    "NS",
    "PTR",
    "SOA",
    "SRV",
    "TXT",
    "TLSA",
    "ANY"
   ],
   "type": "string",
   "title": "DNSLookupRecordType",
   "default": "A"
  },
  "trace": {
   "type": "boolean",
   "title": "Trace",
   "default": false
  },
  "dnssec": {
   "type": "boolean",
   "title": "Dnssec",
   "default": false
  },
  "resolver": {
   "type": "string",
   "title": "Resolver",
   "default": "system"
  },
  "timeout_ms": {
   "type": "integer",
   "title": "Timeout Ms",
   "default": 3000,
   "maximum": 30000,
   "minimum": 500
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rcode": "NOERROR",
  "trace": [],
  "answers": [
   {
    "ttl": 300,
    "name": "example.com",
    "type": "AAAA",
    "value": "2001:db8::1"
   }
  ],
  "question": {
   "name": "example.com",
   "type": "AAAA"
  },
  "resolver": "system",
  "authority": [],
  "additional": [],
  "request_id": "dns_a1b2c3d4",
  "generated_at": "2026-07-15T00:00:00Z"
 }
}
```

## More

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