IP Geolocation

Resolve any IPv4 or IPv6 address to location and network data. Returns country, country_code, city, region, postal, lat/lon, timezone, ISP, org, and ASN. Use for fraud detection, geolocation enrichment, or access log analysis.

Run free trial ↗3 free calls per day with the example input. Paid: $0.002 USDC, no limit.

Call it

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agentsvc.io/api/v1/proxy/ip-lookup", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"ip":"8.8.8.8"}),
});
const { data, payment } = await res.json();  // payment.transaction = on-chain receipt

Input

Field	Type	Description
ip *	string	IPv4 or IPv6 address to look up (e.g. '8.8.8.8' or '2001:4860:4860::8888')

Output

Field	Type	Description
ip	string	The queried IP address
country	string	Full country name
country_code	string	ISO 3166-1 alpha-2 country code
region	string	Region/state name
city	string	City name
postal	string	Postal/ZIP code
lat	number	Latitude
lon	number	Longitude
timezone	string	IANA timezone (e.g. America/New_York)
isp	string	Internet Service Provider name
org	string	Organization name
asn	string	Autonomous System Number (e.g. AS15169)

Example response (data)

{
  "ip": "8.8.8.8",
  "country": "United States",
  "country_code": "US",
  "region": "Virginia",
  "city": "Ashburn",
  "postal": "20149",
  "lat": 39.0438,
  "lon": -77.4874,
  "timezone": "America/New_York",
  "isp": "Google LLC",
  "org": "Google Public DNS",
  "asn": "AS15169"
}