Index onlineMerchant portal
Api Endpoint

IP Geolocation Lookup

IP lookup and geolocation: resolve any public IPv4 or IPv6 address to location and network data from a local database (no third-party call, answers in milliseconds): country, country_code, region, city, lat/lon, IANA timezone, continent, is_eu, ASN with organization (isp, org, asn). Use for fraud and bot checks, geo-routing, analytics, or tagging traffic. Invalid, private and reserved addresses are rejected for free. Params: ip (defaults to the caller's IP).

Open interactive test console

Offering

Provider
agentsvc.io
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Security
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://agentsvc.io/api/v1/proxy/ip-lookup
MIME type
application/json
First seen
2026-10-16T01:50:19.913Z
Last seen
Tags
ip-lookup, ip-geolocation, asn, IP, Geolocation

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.0055 USDC
Atomic price: 5500 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.0055 USDC
Atomic price: 5500 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Payment option 3
0.0055 USDC
Atomic price: 5500 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 4
0.0055 USDC
Atomic price: 5500 · Network: eip155:42161 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5500",
    "payTo": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "5500",
    "payTo": "5JzPS5qpEwUM1vTC9GG7uqvwJdHzbEwfoPHf2Ki977tg"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "5500",
    "payTo": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "5500",
    "payTo": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27"
  }
]

Observed health

Status
Healthy
Latest latency
309 ms
Average latency
625 ms
HTTP status
204
Last checked
Reachability
100% over 12 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ]
    },
    "bodyType": {
      "type": "string",
      "enum": [
        "json",
        "form-data",
        "text"
      ]
    },
    "body": {
      "properties": {
        "ip": {
          "type": "string",
          "description": "IPv4 or IPv6 address to look up (e.g. '8.8.8.8' or '2001:4860:4860::8888')"
        }
      },
      "required": [
        "ip"
      ]
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "object",
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "properties": {
        "body": {
          "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')"
            }
          }
        },
        "type": {
          "type": "string",
          "const": "http"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "output": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string"
        },
        "example": {
          "type": "object",
          "required": [
            "success",
            "data"
          ],
          "properties": {
            "data": {
              "type": "object",
              "required": [
                "ip",
                "country",
                "country_code",
                "city",
                "lat",
                "lon",
                "timezone",
                "isp"
              ],
              "properties": {
                "ip": {
                  "type": "string",
                  "description": "The queried IP address"
                },
                "asn": {
                  "type": "string",
                  "description": "Autonomous System Number (e.g. AS15169)"
                },
                "isp": {
                  "type": "string",
                  "description": "Internet Service Provider name"
                },
                "lat": {
                  "type": "number",
                  "description": "Latitude"
                },
                "lon": {
                  "type": "number",
                  "description": "Longitude"
                },
                "org": {
                  "type": "string",
                  "description": "Organization name"
                },
                "city": {
                  "type": "string",
                  "description": "City name"
                },
                "postal": {
                  "type": "string",
                  "description": "Postal/ZIP code"
                },
                "region": {
                  "type": "string",
                  "description": "Region/state name"
                },
                "country": {
                  "type": "string",
                  "description": "Full country name"
                },
                "timezone": {
                  "type": "string",
                  "description": "IANA timezone (e.g. America/New_York)"
                },
                "country_code": {
                  "type": "string",
                  "description": "ISO 3166-1 alpha-2 country code"
                }
              }
            },
            "success": {
              "type": "boolean"
            }
          }
        }
      }
    }
  }
}