Tool detail

ip402.xyz

Returns normalized geolocation and ASN data for one IPv4 or IPv6 address.

Categories: Domains IP

Use when

look up the location or ASN of an IP address
buy a bundle of IP lookups for later use

Not for

not bulk/batch lookup of many IPs in one call

Inputs

GET query params: ip (string, required); lang (optional, default 'en'); bundle (2-100, optional, prepay n lookups)

Admitted input schema

{
  "type": "object",
  "properties": {
    "bundle": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Optional: pay n x $0.01 once (2 <= n <= 100) and receive n lookup credits (1 hour TTL) bound to the paying wallet, spendable via SIWX signatures. Example: bundle=5 costs $0.05.",
      "examples": [
        5
      ]
    },
    "ip": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "IPv4 or IPv6 address to classify and enrich.",
      "examples": [
        "8.8.8.8",
        "2001:4860:4860::8888"
      ]
    },
    "lang": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional response language for localized GeoIP names.",
      "default": "en",
      "examples": [
        "en",
        "zh-CN"
      ]
    }
  },
  "required": [
    "ip"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://ip402.xyz/v1/geo

Payment

Protocol: x402
Listed price: 0.01 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://ip402.xyz/v1/geo
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z