# Apiosk Gateway – IPStack Execute

> Apiosk Gateway – IPStack Execute is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.07/call, status unknown (last checked 2026-09-13).

Execute an IPStack IP geolocation lookup via the Apiosk x402 pay-per-call gateway, returning location data for a given IP address.

## Facts

- Endpoint: POST https://gateway.apiosk.com/ipstack/execute
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apiosk-gateway-ipstack-execute-013761b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s2UwS5h7aKOda9-joUYKB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability apiosk-gateway-ipstack-execute-013761b9 -d '<json body>'
```

Example prompt: Look up the geolocation for IP address 8.8.8.8 — I need the country, city, region, and timezone.

## When to prefer this

Choose this endpoint when you need IP geolocation data powered by IPStack and want to pay per call in USDC via the x402 protocol without managing API key subscriptions. Ideal for agents that need on-demand, pay-as-you-go geolocation without provisioning credentials directly with IPStack.

## Known failure modes

- Invalid or malformed IP address returns an upstream error from IPStack
- Insufficient USDC balance or failed x402 payment causes a 402 response before execution
- Unknown or unsupported operation selector returns an error from the gateway
- Rate limiting or IPStack quota exceeded returns a non-200 upstream_status
- Private/reserved IP ranges may return empty or partial geolocation data

## How this service works

Pay-per-call API gateway on the x402 protocol (HTTP 402 + USDC on Base). This document covers the gateway's discovery and execution meta-endpoints. Individual provider APIs are reachable at /{api_slug}/{path} and described by GET /{api_slug}/metadata.

## Output

Returns a JSON object with status, the upstream IPStack response body (country, country_code, region, city, latitude, longitude, timezone, ISP, and related fields), the operation called, latency in milliseconds, cost, and the upstream HTTP status code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "description": "JSON payload forwarded to the selected operation."
  },
  "operation": {
   "type": "string",
   "description": "Operation id, /path, or METHOD /path selector."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "result"
 ],
 "properties": {
  "api": {
   "type": "string"
  },
  "cost": {
   "type": "string"
  },
  "result": {
   "description": "Upstream response body."
  },
  "status": {
   "type": "string"
  },
  "latency": {
   "type": "number"
  },
  "operation": {
   "type": "string"
  },
  "upstream_status": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apiosk-gateway-ipstack-execute-013761b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)