# Hyrule Cloud BGP Lookup

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

Looks up BGP routing information for an IP prefix or ASN, returning origin AS, RPKI validity, best-match prefix, and routing sources

## Facts

- Endpoint: POST https://cloud.hyrule.host/v1/bgp/lookup
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyrule-cloud-bgp-lookup-ff94c83d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n0zEdo7kSc5woLtb96Tf9

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-bgp-lookup-ff94c83d -d '<json body>'
```

Example prompt: Can you look up the BGP routing info for the prefix 2a0c:b641:b50::/44 — I want to know which AS originates it, whether the route is RPKI-valid, and if it's actually being routed right now?

## When to prefer this

Choose this endpoint when you need authoritative BGP routing data including RPKI validation status for a specific IP prefix or ASN, especially in a network intelligence or security context. Prefer it over generic WHOIS or IP geolocation tools when the goal is to verify route origins, check BGP reachability, or audit routing security. It pays per request in USDC via x402, making it suitable for on-demand agent workflows without subscription overhead.

## Known failure modes

- Invalid or unroutable prefix format returns empty results
- Subject not found in BGP tables returns routed: false
- Malformed ASN or prefix input may return a 400 error
- Partial results flag may be true if some BGP sources are unavailable
- Rate limiting or payment failure via x402 returns 402 Payment Required

## How this service works

Hyrule Cloud is pay-per-use infrastructure for AI agents on AS215932: IPv6-native compute, outbound requests over Direct, Tor, I2P, or Yggdrasil, BGP/routing intelligence, IP/ASN intelligence, DNS diagnostics, RDAP/WHOIS registry lookups, web and deep TLS checks, mail deliverability, outside-in port reachability, NAT port-forward checks, VoIP/SIP diagnostics. Calls settle in USDC via x402. This endpoint: Paid BGP/routing lookup by prefix, IP, ASN, or AS215932 router-table dataset.

## Output

Returns a JSON object with the subject (type and value), resolved routing details (routed boolean, origin ASNs with RPKI status and sources, best matching prefix, observed origin ASNs), partial flag, source data, assertions, request ID, generation timestamp, and charged amount in USD.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "partial": false,
  "results": {},
  "sources": {},
  "subject": {
   "type": "prefix",
   "value": "2a0c:b641:b50::/44"
  },
  "resolved": {
   "routed": true,
   "origins": [
    {
     "asn": 215932,
     "rpki": "valid",
     "sources": [
      "as215932"
     ]
    }
   ],
   "best_prefix": "2a0c:b641:b50::/44",
   "observed_origin_asns": [
    215932
   ]
  },
  "assertions": {},
  "request_id": "bgp_a1b2c3d4",
  "generated_at": "2026-07-15T00:00:00Z",
  "charged_amount_usd": "0.005"
 }
}
```

## More

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