# Tollkit IP Lookup

> Tollkit IP Lookup is a paid API for AI agents from chain.tollkit.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Looks up geolocation and metadata for a given IPv4 or IPv6 address, payable per-call via x402 in USDC with no account or API key required.

## Facts

- Endpoint: POST https://chain.tollkit.dev/ip?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tollkit-ip-lookup-dc039a34
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AlDMt-RXvHmpCZe43agao

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 tollkit-ip-lookup-dc039a34 -d '<json body>'
```

Example prompt: Can you look up the geolocation and network info for the IP address 203.0.113.42? I just need to know what country and ISP it belongs to.

## When to prefer this

Choose this endpoint when you need fast, pay-per-call IP geolocation with no account setup or API key management — ideal for agentic workflows where you need to enrich a small number of IPs on-demand and want to pay in USDC via x402. Prefer this over subscription-based IP lookup services when usage is sporadic or when you want frictionless, accountless access.

## Known failure modes

- Invalid IP address format returns a validation error
- Private or reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) may return no geolocation data
- Payment failure via x402 protocol results in a 402 response and no data returned
- Unroutable or bogon IPs may return empty or partial results
- Rate limiting or network timeout if the upstream IP database is unavailable

## How this service works

Pay-per-call product page extraction. No account, no API key: pay in-band with x402 in USDC on Base or Solana.

## Output

Returns geolocation and network metadata for the provided IP address, including country, city, region, ISP, ASN, and potentially organization details associated with the IP.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ip": {
   "type": "string",
   "description": "IPv4 or IPv6 address."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tollkit-ip-lookup-dc039a34/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.tollkit.dev](https://www.zero.xyz/host/chain.tollkit.dev/llms.txt)