Pay-per-call IP intelligence: geolocation, ASN, privacy, carrier, and hosting data via IPinfo.
What it does
This endpoint provides comprehensive IP address intelligence powered by IPinfo, exposed through the Locus MPP (Micropayment Protocol) gateway. By sending a POST request with an IPv4 address, IPv6 address, or the string "me" (to look up the caller's own IP), you receive detailed information including geolocation, ASN (Autonomous System Number), privacy/VPN detection, carrier identification, and hosting provider data.
The endpoint is priced at 1,000 base units of pathUSD (currency address 0x20c…b9537d11c60e8b50) per request, which equals $0.001 (one-tenth of a cent) assuming pathUSD uses 6 decimals. Payment is settled on Tempo L2 with a one-shot "charge" intent, meaning each call is independently paid. A sibling endpoint, `/ipinfo/ip-lite`, is available at the same price for a lighter-weight lookup.
Note: The probe attempted HEAD and GET requests and received 404 responses; however, the OpenAPI spec declares this as a POST-only endpoint, so the 404s on non-POST methods are expected behavior. The endpoint should be live when called with the correct POST method and a valid MPP payment header. No response schema is documented in the OpenAPI spec, so the exact shape of the returned JSON must be inferred from IPinfo's public API documentation.
Capabilities
Use cases
- —Enriching log data with geographic and network metadata for each visitor IP
- —Detecting VPN/proxy usage for fraud prevention or compliance workflows
- —Identifying hosting providers and data-center IPs to filter bot traffic
- —Geo-targeting content or ads based on a user's IP-derived location
- —Performing real-time ASN and carrier lookups in network monitoring pipelines
Fit
Best for
- —Agents or services that need on-demand, pay-per-call IP intelligence without a subscription
- —Automated pipelines requiring geolocation, ASN, and privacy signals in a single call
- —Developers who want crypto-settled micropayments (Tempo L2) instead of API-key billing
Not for
- —High-volume batch lookups where a flat-rate subscription would be more economical
- —Use cases requiring only basic geolocation (the cheaper /ipinfo/ip-lite endpoint may suffice)
Quick start
curl -X POST https://ipinfo.mpp.paywithlocus.com/ipinfo/ip-lookup \
-H "Content-Type: application/json" \
-H "Authorization: <MPP_PAYMENT_HEADER>" \
-d '{"ip": "8.8.8.8"}'Example
Request
{
"ip": "8.8.8.8"
}Endpoint
Quality
The OpenAPI spec provides clear request schema, pricing, and endpoint metadata, but no response schema is documented. The probe only tested HEAD/GET (both 404) while the endpoint is POST-only, so liveness via POST is unconfirmed but expected. Crawled pages returned no useful documentation. Response shape must be inferred from upstream IPinfo docs.
Warnings
- —No response schema defined in the OpenAPI spec; exact JSON structure of successful responses is unknown.
- —Probe did not test POST method, so 402 challenge was not captured directly; liveness is inferred from the OpenAPI spec declaring POST as the correct method.
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals; if decimals differ, the stated price ($0.001) would be incorrect.
- —No crawled documentation was available from the provider origin; all non-endpoint paths return 404.
Citations
- —The endpoint accepts POST with a JSON body containing an 'ip' field (IPv4, IPv6, or 'me').https://ipinfo.mpp.paywithlocus.com
- —Price is 1000 base units of currency 0x20c…b9537d11c60e8b50, settled via Tempo L2 with charge intent.https://ipinfo.mpp.paywithlocus.com
- —IPinfo provides geolocation, ASN, privacy detection, carrier data, and hosting identification.https://ipinfo.io
- —API reference documentation is available at ipinfo.io/developers.https://ipinfo.io/developers
- —LLM-oriented docs referenced at beta.paywithlocus.com/mpp/ipinfo.md.https://beta.paywithlocus.com/mpp/ipinfo.md