# P0 Agent Economy Index – IP Passport (IP Lookup)

> P0 Agent Economy Index – IP Passport (IP Lookup) is a paid API for AI agents from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-20).

Looks up a public IPv4 or IPv6 address and returns its ASN, country, announced range, Tor exit status, and cloud provider membership (AWS, GCP, Cloudflare, Oracle).

## Facts

- Endpoint: GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/ip/passport?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/p0-agent-economy-index-ip-passport-ip-lookup-89b94e00
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5RRDcfJa21hI358MQmQS1

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 p0-agent-economy-index-ip-passport-ip-lookup-89b94e00
```

Example prompt: Can you look up the IP address 3.5.140.10 and tell me whether it's a Tor exit node, what cloud provider owns it, and which ASN and country it belongs to?

## When to prefer this

Choose this endpoint when you need factual, source-cited IP metadata — ASN, country, routing, Tor exit status, and cloud provider — without inference or reputation scoring. It is ideal for agents that need traceable, auditable lookups with licence attribution. Prefer it over general IP geolocation services when cloud provider classification (AWS/GCP/Cloudflare/Oracle) and Tor detection are required simultaneously. Not suitable for device-level geolocation or fraud scoring.

## Known failure modes

- Unrouted (private/reserved) IP addresses are refused before payment is processed
- IPv6 addresses return null for Tor exit status (only IPv4 is checked against Tor bulk exit list)
- Cloud field is null if the IP is not listed by AWS, GCP, Cloudflare, or Oracle
- Stale data if upstream IP range feeds have not been refreshed recently (as_of reflects oldest dataset)
- Invalid IP format returns an error before payment

## How this service works

An open index of the machine-to-machine (agent) economy. x402 routes: ranked discovery over a verified x402 seller set (sellers whose 402 P0 read itself plus registry-verified entries), scored by relevance and evidence of a live 402 challenge, with a receipt naming the snapshot hash and scoring revision; demand figures are P0's own on-chain counts of transfers to the sellers' wallets. /economy routes, for Tempo MPP, Virtuals ACP, Olas, Masumi, ERC-8004 agent registries, Solana agent registries, Base agent contracts and MCP servers (Official MCP Registry): each protocol's published figures (agent or server counts, transactions or payment events; payers and USD volume only where the source publishes them: payers for x402 and Tempo MPP, USD volume for x402 and Virtuals ACP), each with its unit, window and source; units differ, so totals are not summed. L402 listings are not covered.

## Output

A JSON object containing: the parsed IP address, IP version, routing status, ASN number and name, country code, announced IP range (start/end), Tor exit node status with list date, cloud provider details (provider name, CIDR, region, services) or null if not in a known cloud range, a list of data sources with fetch times and licences, and an as_of timestamp for the oldest dataset used. Explicitly not a fraud or reputation verdict — only raw registry data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ip"
     ],
     "properties": {
      "ip": {
       "type": "string",
       "maxLength": 45
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "description": "Shortened to fit the header; full example and schema: https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/openapi.json"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ip": "3.5.140.10",
  "asn": 16509,
  "note": "Every field is what the named source lists, read at the shown time; nothing is inferred. country is the country code attached to the range in the iptoasn data, not a device geolocation. routed:false addresses are refused before payment. tor_exit.listed is true only if the address is in the Tor bulk exit list at list_date (IPv4 only; null for IPv6). cloud shows the provider's most specific published prefix containing the address; services is the union of services listed on all containing prefixes of that provider; null means none of AWS, Google Cloud, Cloudflare or Oracle Cloud lists it. Not a reputation or fraud verdict.",
  "as_of": "2026-10-25T09:21:20.000Z",
  "cloud": {
   "cidr": "3.5.140.0/22",
   "region": "ap-northeast-2",
   "provider": "aws",
   "services": [
    "AMAZON",
    "S3"
   ],
   "list_date": "2026-10-25T06:17:05Z",
   "provider_name": "Amazon Web Services"
  },
  "range": {
   "end": "3.5.143.255",
   "start": "3.5.140.0"
  },
  "routed": true,
  "as_name": "AMAZON-02",
  "country": "US",
  "sources": [
   {
    "url": "https://iptoasn.com/data/ip2asn-combined.tsv.gz",
    "name": "iptoasn.com IP-to-ASN",
    "fetched": "2026-10-25T09:21:20Z",
    "licence": "Public Domain (PDDL v1.0)",
    "list_date": "2026-10-25T04:42:44Z"
   },
   {
    "url": "https://check.torproject.org/torbulkexitlist",
    "name": "Tor Project bulk exit list",
    "fetched": "2026-10-25T09:22:54Z",
    "licence": "Tor Project data: CC0",
    "list_date": "2026-10-25T09:05:04Z"
   },
   {
    "url": "https://ip-ranges.amazonaws.com/ip-ranges.json",
    "name": "AWS IP ranges",
    "fetched": "2026-10-25T09:23:10Z",
    "licence": "published by AWS, no licence text",
    "list_date": "2026-10-25T06:17:05Z"
   }
  ],
  "version": 4,
  "tor_exit": {
   "listed": false,
   "list_date": "2026-10-25T09:05:04Z"
  },
  "attribution": [
   "ASN, AS name and country: iptoasn.com IP-to-ASN database (public domain, PDDL v1.0), https://iptoasn.com/",
   "Tor exit list: Tor Project bulk exit list, https://check.torproject.org/torbulkexitlist (Tor Project data is released under CC0)",
   "AWS IP ranges: Amazon Web Services, https://ip-ranges.amazonaws.com/ip-ranges.json"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/p0-agent-economy-index-ip-passport-ip-lookup-89b94e00/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev](https://www.zero.xyz/host/x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/llms.txt)
