# ENS / Basename Expiry Checker

> ENS / Basename Expiry Checker is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-15).

Returns expiration date, days remaining, grace period end, registrant address, and registration availability for a .eth or .base.eth name.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/ens-expiry?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ens-basename-expiry-checker-5594a910
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pmFinHKg9szlilthNug9G

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 ens-basename-expiry-checker-5594a910 -d '<json body>'
```

Example prompt: When does vitalik.eth expire, how many days are left, and is it currently free to register?

## When to prefer this

Use this endpoint when you need authoritative expiry and availability data specifically for .eth or .base.eth names. It covers both Ethereum mainnet ENS names and Base network Basenames in a single call, returning structured expiry metadata including grace period details — more complete than a simple availability check. Prefer it over generic domain RDAP checkers (which may not support ENS) when your use case involves ENS renewal timing, sniping expired names, or verifying ownership.

## Known failure modes

- Name not found or unregistered — fields may return null or registered:false
- Invalid name format (missing .eth suffix) — request rejected
- Network timeout or ENS resolver unavailable — no response
- Name in auction limbo after grace period — status may differ from expected

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

A JSON object with the queried name, its network (ethereum or base), whether it is registered, the expiration date (ISO date string), days remaining as a decimal, grace period end date, the record owner's Ethereum address, whether it is free to register, and an explanatory note about the grace/auction process.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "name.eth or name.base.eth"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "free": false,
  "name": "vitalik.eth",
  "note": "After expiry there are 90 days of grace to renew; then it goes to a temporary auction and becomes available.",
  "status": "active",
  "expires": "2048-01-31",
  "network": "ethereum",
  "registered": true,
  "record_owner": "0x220866B1A2219f40e72f5c628B65D54268cA3A9D",
  "remaining_days": 7790.4,
  "grace_period_end": "2048-04-30"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ens-basename-expiry-checker-5594a910/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)