# GeekVault ASN Lookup

> GeekVault ASN Lookup is a paid API for AI agents from api.geekvault.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-30).

Resolves a hostname or IPv4 address to its Autonomous System Number (ASN), prefix, AS name, country, and registry information.

## Facts

- Endpoint: GET https://api.geekvault.dev/net-tools/v1/asn-lookup?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/geekvault-asn-lookup-313194b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B_9bUz8xT_xIkt8Lj3e9P

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 geekvault-asn-lookup-313194b0
```

Example prompt: Can you look up the ASN and network owner for the hostname api.openai.com — I want to know what autonomous system it belongs to, its IP prefix, and what country it's registered in?

## When to prefer this

Choose this endpoint when you need lightweight, pay-per-call ASN and network ownership lookup without managing API keys or subscriptions. Ideal for agents enriching security alerts, validating hosting providers, or performing network triage. Best for single-host queries billed at $0.003 USDC per call via x402 on Base — no account setup required.

## Known failure modes

- Host cannot be resolved to an IP (DNS failure) — resolved_ip may be missing or error returned
- ASN data unavailable for private/reserved IP ranges — asn, prefix, as_name, country, registry returned as null
- Invalid input format (non-hostname, non-IPv4 string) — likely 4xx error
- Payment failure via x402 — 402 response before lookup is attempted
- Timeout if DNS resolution takes too long for unresponsive hostnames

## How this service works

Network, docs, image, web, and dev utility tools paid per call via x402. No signup, no API keys, no subscriptions — just USDC on Base.

## Output

Returns a JSON object with the original host, its resolved IPv4 address, ASN string (e.g. 'AS15169'), IP prefix (CIDR block), AS name (the organization name), country code, and registry (e.g. ARIN, RIPE). Any field may be null if the information is unavailable for the queried IP.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "host"
 ],
 "properties": {
  "host": {
   "type": "string",
   "description": "Hostname o IPv4. Si es hostname, se resuelve a IP primero (registro A)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "host",
  "resolved_ip"
 ],
 "properties": {
  "asn": {
   "type": [
    "string",
    "null"
   ]
  },
  "host": {
   "type": "string"
  },
  "prefix": {
   "type": [
    "string",
    "null"
   ]
  },
  "as_name": {
   "type": [
    "string",
    "null"
   ]
  },
  "country": {
   "type": [
    "string",
    "null"
   ]
  },
  "registry": {
   "type": [
    "string",
    "null"
   ]
  },
  "resolved_ip": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/geekvault-asn-lookup-313194b0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.geekvault.dev](https://www.zero.xyz/host/api.geekvault.dev/llms.txt)