IP Geolocation

security

Serving

IP geolocation: country, region, city, postal code, coordinates, ASN and organisation for an IPv4 or IPv6 address. Looked up from ipapi.co and cached. POST /v1/ip with {ip} and get one JSON object back. Pay per request in USDC; no account, no API key.

Endpoint: POST https://agent.pocket.network/v1/ip-geolocation/v1/ip
Price per call: $0.005 USD
Networks payable on: Base (eip155:8453)
Protocol: rest

Calling it

The first call returns 402 Payment Required with the terms. Sign for those terms and retry the same request with the payment attached.

Example request

Derived from the published request schema.

curl -X POST https://agent.pocket.network/v1/ip-geolocation/v1/ip \
  -H 'content-type: application/json' \
  -d '{"ip":"8"}'

Example response

This service declares its response shape in prose rather than as fields, so there is nothing more specific to sample.

{}

Try it

Make one real paid call from your own wallet — about $0.005 on Base (eip155:8453). The wallet signs; nothing here holds a key. You'll see exactly what the service answers.

No browser wallet found. Install MetaMask, Rabby, or Coinbase Wallet to try a call here.

EndpointRequest body

Supported methods

Methods the registry lists for this service. The portal forwards any call as sent; the supplier decides what it answers, and a delivered answer is settled.

Methods IP Geolocation accepts, and whether each reads or writes.
Method	Effect
`GET /v1/health`	read
`GET /v1/version`	read
`POST /v1/ip`	read

Schemas

Published by the service itself. The example above is generated from these.

Request schema

{
  "type": "object",
  "description": "The request body for POST /v1/ip.",
  "properties": {
    "ip": {
      "type": "string",
      "description": "IPv4 or IPv6 address, e.g. 8.8.8.8."
    }
  },
  "required": [
    "ip"
  ]
}

Response schema

{
  "type": "object",
  "description": "For POST /v1/ip, a JSON object with country, country_code, region, city, postal, lat, lon, asn, org and source. The exact shape is the service's own and is not pinned here; errors return a JSON object with an `error` field."
}