IP Lookup

Pay per call · no API key

IP Lookup

Geolocation, ASN, proxy and threat intelligence for any IP address.

Your agent pays a few cents in USDC per request over x402. No account, no subscription, no key to rotate — and a failed lookup is never charged.

Call it in three steps

Any x402 v2 client works. This uses @x402/fetch with a viem wallet.

Step 1

See the terms

An unpaid request returns 402 with the price and accepted chains.

curl -i https://ipx402.com/v1/ip?ip=8.8.8.8
Step 2

Install a client

Wraps fetch so payment is signed and retried for you.

npm i @x402/fetch viem
Step 3

Pay and call

The wrapped fetch settles payment and returns the data.

const f = wrapFetchWithPayment(fetch, wallet);
await f("https://ipx402.com/v1/ip?ip=8.8.8.8");

Endpoints

Every route accepts POST with a JSON body or GET with query parameters. Fields and response shapes are declared in openapi.json.

POST /v1/ip

resolve geolocation, ASN, ISP and proxy status for an IP address

  • iprequiredIPv4 or IPv6 address to look up, e.g. "8.8.8.8".
$0.01 per call

Payment

Priced in USDC and settled over x402. Pick whichever chain your wallet holds — both are offered on every paid route at the same price.

Price per call$0.01 USDC
Base baseeip155:8453
0x1C2Eb89273135175Ae7F24A7C93f0bF5D61Eb793
Solanasolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
H6YQh5EHWdmu56j8KUWjVvR7M6yvUhHM2ekydPHEs9sR
Protocolx402 v2 · scheme exact
Not charged whenthe request is malformed (400), the provider fails (502/503), or the lookup times out (504). Only a 2xx response is billed.

Questions

What does an IP lookup return?

Country, region, city, latitude and longitude, postal code and timezone, plus the ISP and ASN behind the address and whether it belongs to a known proxy or VPN, including the proxy type and provider where known.

Do I need an API key?

No. There is no account, key or subscription. Requests are paid per call in USDC over the x402 protocol, so any agent or client with a funded wallet can call the API immediately.

What does an IP lookup cost?

Each lookup costs $0.01 in USDC, payable on Base or Solana at the same price. Failed lookups are never charged — only a successful response settles payment.

Can it detect VPNs and proxies?

Yes. Responses include an is_proxy flag and, when the address is a known proxy, its type, usage category, hosting domain and provider.