# IP Geolocation API

Turn an IP into a place and network.

| Field | Value |
| --- | --- |
| Provider | APIStead Labs |
| Category | Address & Location |
| Networks | Base |
| Price | $0.001 per call |
| Base URL | https://apistead.qd.je/api/v1 |
| Verification | verified (2/2 routes) |
| Last verified | 2026-11-13T13:52:21.457Z |
| Receipt | https://basescan.org/tx/0x638e71f65c2bcc4874eb8b4eb9fde19d59d9df33c94b12c95ead4913e1522d44 |
| JSON | https://x402.apistead.qd.je/api/apis/ip-geolocation-api |
| Markdown | https://x402.apistead.qd.je/api/apis/ip-geolocation-api/md |
| MCP | https://apistead.qd.je/mcp |
| API reference | https://x402.apistead.qd.je/api |
| OpenAPI | https://x402.apistead.qd.je/openapi.json |

## For AI agents

Turn a public IP address into approximate country, region, city, timezone, ASN and organisation data.

## Scope

Approximate location only. Not for identity, precise location, private IPs or fraud decisions without another signal.

## Agent intents

- look up an IP address
- find the country and city for an IP
- get the ASN for an IP
- enrich a request with IP location

Agents use IP data for fraud checks, localization, content routing, analytics and network diagnostics. This API returns a compact, stable shape with the fields that matter and a confidence-friendly `source` label.

Use `/ip/me` to inspect the caller's own address, or `/ip/{address}` for a specific public IP. Private and reserved ranges are rejected with a clear error instead of a misleading location.

## Endpoints

### GET /ip/me

Look up the caller's own public IP.

- URL: https://apistead.qd.je/api/v1/ip/me
- Price: $0.001 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.673Z
- Latency: 11 ms
- Uptime (30d): 86.87%

Example request:

```http
GET https://apistead.qd.je/api/v1/ip/me
```

Example response:

```json
{
  "ip": "203.0.113.10",
  "city": "London",
  "country": "United Kingdom",
  "country_code": "GB"
}
```

### GET /ip/{ip}

Look up a public IPv4 or IPv6 address.

- URL: https://apistead.qd.je/api/v1/ip/{ip}
- Price: $0.001 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.600Z
- Latency: 3 ms
- Uptime (30d): 85.86%

Example request:

```http
GET https://apistead.qd.je/api/v1/ip/8.8.8.8
```

Example response:

```json
{
  "ip": "8.8.8.8",
  "asn": "AS15169",
  "city": "San Jose",
  "region": "California",
  "source": "ipwho.is",
  "country": "United States",
  "latitude": 37.3394,
  "timezone": "America/Los_Angeles",
  "longitude": -121.895,
  "country_code": "US"
}
```

## Payment

Every paid route uses x402 over HTTP. Call the route without payment to receive a 402 challenge, then pay the quoted USDC amount and retry. The 402 challenge is the authoritative source for price, asset, network and pay-to address. Reading this record and the discovery API is free.

- Protocol: x402 v2
- Asset: USDC
- Networks: Base
- Price: $0.001 per call

## Verification

- State: verified
- Routes verified: 2/2
- Last verified: 2026-11-13T13:52:21.457Z
- Receipt: https://basescan.org/tx/0x638e71f65c2bcc4874eb8b4eb9fde19d59d9df33c94b12c95ead4913e1522d44

## Agent links

- JSON: https://x402.apistead.qd.je/api/apis/ip-geolocation-api
- Markdown: https://x402.apistead.qd.je/api/apis/ip-geolocation-api/md
- Routes: https://x402.apistead.qd.je/agent/routes?id=ip-geolocation-api
- Receipts: https://x402.apistead.qd.je/agent/receipts?id=ip-geolocation-api
- API reference: https://x402.apistead.qd.je/api
- MCP guide: https://x402.apistead.qd.je/mcp-docs
- Agent skill: https://x402.apistead.qd.je/skill
- OpenAPI: https://x402.apistead.qd.je/openapi.json
- MCP: https://apistead.qd.je/mcp
- Docs: https://apistead.qd.je/api


## Changelog

### 1.0.0 - Initial verified release

The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.

release · 2026-11-11 · APIStead Labs