Explorer
Syncing—

IP GeolocationService

ip-geolocation

Approximate location of an IPv4 or IPv6 address. POST JSON {"ip": "8.8.8.8"} to /v1/geo; the response is a JSON object with ip, country, country_code, region, city, postal, lat, lon, asn, org, source and cached. Invalid addresses return a 400. Data is cached 24 hours per IP.

Active Suppliers
0
of 0 ever configured
Service Info
Service ID
ip-geolocation
Compute Units / Relay
50,000
Owner
pokt15…a5px
Active Applications
1
Relay Mining EMA
1 relays
Service Metadata Cardsource: on-chain metadata (LCD)
{10 items
"schema":"pocket-service-card/v1"
"description":"Approximate location of an IPv4 or IPv6 address. POST JSON {"ip": "8.8.8.8"} to /v1/geo; the response is a JSON object with ip, country, country_code, region, c..."
"rpc_types":[1 item
0:{4 items
"type":"REST"
"intent":"expected"
"backend_hint":"ip-geolocation HTTP server on :8080; POST /v1/geo (also POST /v1/tool), GET /v1/health + /v1/version."
"notes":"Every response is a JSON object; errors are JSON 4xx with an error field."
}
]
"apis":[1 item
0:"ipgeo-api"
]
"specs":[1 item
0:{4 items
"kind":"openapi"
"api":"ipgeo-api"
"url":"https://main.aristeon.org/ip-geolocation/openapi.json"
"notes":"Machine-readable OpenAPI 3.0.3 contract for this service, with example requests."
}
]
"access":"public"
"results":"variable"
"serving":{7 items
"backend":"Single-process Python 3 HTTP server, standard library only, behind a RelayMiner (rest backend). No auth toward the backend; callers cannot send headers. Looks t..."
"implementations":[1 item
0:"ip-geolocation >= 1.0"
]
"docs":"https://main.aristeon.org/ip-geolocation/README.md"
"min_disk_gb":1
"min_ram_gb":1
"healthcheck":[3 items
0:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/version"
"method":"GET"
}
"expect":{2 items
"json_path":"$.service"
"matches":"^ip-geolocation$"
}
"notes":"Identity probe: pins the backend to this service so a wrong backend cannot be staked under this id."
}
1:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/health"
"method":"GET"
}
"expect":{2 items
"json_path":"$.status"
"matches":"^ok$"
}
"notes":"Readiness probe."
}
2:{4 items
"rpc_type":"REST"
"request":{3 items
"path":"/v1/geo"
"method":"POST"
"body":{1 item
"ip":"8.8.8.8"
}
}
"expect":{2 items
"json_path":"$.country_code"
"matches":"^US$"
}
"notes":"Functional probe: 8.8.8.8. One upstream call unless cached."
}
]
"notes":"Upstream: ipapi.co, whose free tier is rate-limited and whose terms restrict commercial reuse; suppliers must check their use complies. Gateway operators: confi..."
}
"docs":"https://main.aristeon.org/ip-geolocation/README.md"
"updated":"2026-09-29"
}