# TokenGuard WHOIS Domain Lookup

> TokenGuard WHOIS Domain Lookup is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Returns domain registration metadata including creation date, expiration date, registrar, and nameservers for a given domain name.

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/data/whois
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-whois-domain-lookup-2882655c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eL3Eg7Pn3rY6NC_GlQGks

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 tokenguard-whois-domain-lookup-2882655c -d '<json body>'
```

Example prompt: Can you look up the WHOIS record for example.com — I want to know when it was created, when it expires, who the registrar is, and what nameservers it uses?

## When to prefer this

Use this endpoint when you need structured, machine-readable WHOIS/domain registration data including creation, expiration, registrar, and nameservers — especially in a crypto/DeFi or AI agent context where x402 micropayment billing ($0.005/call) is already in use and you want WHOIS data as part of a broader on-chain or web intelligence workflow.

## Known failure modes

- Domain not found or does not exist — likely returns an error or empty result
- Invalid domain format — malformed input may return a validation error
- WHOIS data unavailable for certain TLDs — some domains have restricted WHOIS data
- Rate limiting or payment failure — x402 micropayment not accepted or insufficient funds
- Timeout if the upstream WHOIS registry is slow or unreachable

## How this service works

Domain registration facts over RDAP (structured WHOIS): registrar, creation and expiry dates, status codes, nameservers

## Output

A JSON object containing the domain's creation date (ISO 8601), expiration date (ISO 8601), registrar name, and an array of nameserver hostnames. For example: {"domain":"example.com","created":"1995-08-14T04:00:00Z","expires":"2026-08-13T04:00:00Z","registrar":"RESERVED-IANA","nameservers":["a.iana-servers.net"]}.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "domain": {
   "type": "string",
   "description": "Bare domain, e.g. example.com"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "domain": "example.com",
  "created": "1995-08-14T04:00:00Z",
  "expires": "2026-08-13T04:00:00Z",
  "registrar": "RESERVED-IANA",
  "nameservers": [
   "a.iana-servers.net"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-whois-domain-lookup-2882655c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)
