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".
Pay per call · no API key
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.
Any x402 v2 client works. This uses @x402/fetch with a viem wallet.
An unpaid request returns 402 with the price and accepted chains.
curl -i https://ipx402.com/v1/ip?ip=8.8.8.8
Wraps fetch so payment is signed and retried for you.
npm i @x402/fetch viem
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");
Every route accepts POST with a JSON body or GET with query parameters. Fields and response shapes are declared in openapi.json.
resolve geolocation, ASN, ISP and proxy status for an IP address
iprequiredIPv4 or IPv6 address to look up, e.g. "8.8.8.8".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 base | eip155:84530x1C2Eb89273135175Ae7F24A7C93f0bF5D61Eb793 |
| Solana | solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpH6YQh5EHWdmu56j8KUWjVvR7M6yvUhHM2ekydPHEs9sR |
| Protocol | x402 v2 · scheme exact |
| Not charged when | the request is malformed (400), the provider fails (502/503), or the lookup times out (504). Only a 2xx response is billed. |