UtilityActive

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.

Endpointx402 Payment Required

POST

https://agentsvc.io/api/v1/proxy/ip-lookup

Price

$0.001 USDC

Latency P99

~150ms

Provider

agentsvc.io

Input Schema

{
  "type": "object",
  "required": [
    "ip"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "description": "IPv4 or IPv6 address to look up (e.g. '8.8.8.8' or '2001:4860:4860::8888')"
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "ip",
    "country",
    "country_code",
    "city",
    "lat",
    "lon",
    "timezone",
    "isp"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "description": "The queried IP address"
    },
    "country": {
      "type": "string",
      "description": "Full country name"
    },
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code"
    },
    "region": {
      "type": "string",
      "description": "Region/state name"
    },
    "city": {
      "type": "string",
      "description": "City name"
    },
    "postal": {
      "type": "string",
      "description": "Postal/ZIP code"
    },
    "lat": {
      "type": "number",
      "description": "Latitude"
    },
    "lon": {
      "type": "number",
      "description": "Longitude"
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone (e.g. America/New_York)"
    },
    "isp": {
      "type": "string",
      "description": "Internet Service Provider name"
    },
    "org": {
      "type": "string",
      "description": "Organization name"
    },
    "asn": {
      "type": "string",
      "description": "Autonomous System Number (e.g. AS15169)"
    }
  },
  "example": {
    "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"
  }
}

Code Examples

# Step 1: Call without payment → receive 402 with requirements
curl -X POST "https://agentsvc.io/api/v1/proxy/ip-lookup" \
  -H "Content-Type: application/json" \
  -d '{
  "ip": "8.8.8.8"
}'

# Step 2: Sign payment using x402 SDK, then retry
curl -X POST "https://agentsvc.io/api/v1/proxy/ip-lookup" \
  -H "Content-Type: application/json" \
  -H "X-Payment: x402 usdc base <your-signed-payment>" \
  -d '{
  "ip": "8.8.8.8"
}'

IP Geolocation

Input Schema

Output Schema

Code Examples

Tags

Service Info