ip402.xyz | Apiosk Gateway

Base URL

https://gateway.apiosk.com/cbz-ip402-xyz

Technical Specs

Auth MethodNone (x402 payment proof only)

Response FormatJSON

Endpoints1

Endpoints

Method	Path	Description	Cost
GET	/v1/geo	Paid IP intelligence endpoint returning normalized geolocation and ASN data for a single IPv4 or IPv6 address.	$0.01 default	View details

Endpoint documentation

GET/v1/geo

$0.01 default

Description

Paid IP intelligence endpoint returning normalized geolocation and ASN data for a single IPv4 or IPv6 address.

Pricing

$0.01 default

Parameters

{
  "additionalProperties": false,
  "properties": {
    "bundle": {
      "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
      ],
      "type": "integer"
    },
    "ip": {
      "description": "IPv4 or IPv6 address to classify and enrich.",
      "examples": [
        "8.8.8.8",
        "2001:4860:4860::8888"
      ],
      "type": "string"
    },
    "lang": {
      "default": "en",
      "description": "Optional response language for localized GeoIP names.",
      "examples": [
        "en",
        "zh-CN"
      ],
      "type": "string"
    }
  },
  "required": [
    "ip"
  ],
  "type": "object"
}

Example response

{
  "data_source": {
    "build_epoch": 1760000000,
    "edition": "city+asn",
    "provider": "ip402"
  },
  "geo": {
    "continent": {
      "code": "NA",
      "name": "North America"
    },
    "country": {
      "iso_code": "US",
      "name": "United States"
    },
    "location": {
      "accuracy_radius_km": 1000,
      "latitude": 37.751,
      "longitude": -97.822,
      "time_zone": "America/Chicago"
    }
  },
  "ip": "8.8.8.8",
  "ip_version": 4,
  "network": {
    "asn": 15169,
    "organization": "Google LLC"
  },
  "resolution_status": "ok",
  "schema_version": 2,
  "scope": "public"
}